> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pickcel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Display Dashboards on Your Digital Signage Screens with Pickcel?

The Pickcel Dashboard App allows you to securely display dynamic, read-only views of your favorite service dashboards like Jira, Power BI, Salesforce, and more directly on your digital signage screens. It works by using a secure, server-side browser to log in, take screenshots of your dashboards at set intervals, and send them to your displays.

<Note> This guide provides a complete overview of the setup process. While the process is detailed, it can be broken down into three main stages: **Preparation**, **Configuration**, and **Publishing**. </Note>

***

## Part 1: Before You Begin - Essential Preparation

Proper preparation is key to a smooth setup. Before you start creating the app in Pickcel, we highly recommend getting the following items in order.

<Steps>
  <Step title="Create a Dedicated Service Account (Best Practice)">
    For enhanced security and easier management, create a dedicated service account in the platform you want to display (e.g., a new read-only user in Jira or Salesforce). Use this account's credentials for Pickcel instead of a personal, high-privilege account.
  </Step>

  <Step title="Gather Your Credentials">
    For the specific service account you will be using, make sure you have:

    * The direct **Login URL**
    * The **Email/Username** and **Password**
    * The **final Dashboard URL** that you want to display on screen
  </Step>

  <Step title="Set Up 2-Factor Authentication (If Required)">
    Many services like Jira, Trello, and Power BI require 2FA. For our system to log in automatically, it must be able to generate the required 6-digit 2FA code on its own, without any manual entry. This is made possible by using a text-based **Secret Key**. You can retrieve this key during the 2FA setup process by choosing the "manual setup" or "can't scan code" option.

    <Info>
      For detailed instructions on how to enable 2FA and get the secret key from your service provider, please see our complete guide: [How to Set Up 2FA and Get a Secret Key](/apps/dashboard-apps/2fa-setup)
    </Info>
  </Step>
</Steps>

***

## Part 2: The General 4-Step Configuration Process

Once you have your credentials ready, you can configure the app. The following steps are the same for all dashboard types.

<Steps>
  <Step title="Create the Dashboard App in Pickcel">
    * Log in to the Pickcel Console and navigate to **Apps**
    * Search for the **Dashboard** app and click **Create App**
    * Give your app a descriptive name (e.g., "Sales Team Leaderboard - Salesforce")
  </Step>

  <Step title="Authenticate Your Service">
    * Select your desired service (e.g., Jira, Trello, Power BI) from the dropdown menu
    * On the right-hand side, carefully fill in the required authentication fields (Login URL, Email, Password, 2FA Secret Key, etc.)
    * Click the **Generate Auth Token** button. A secure token will be generated and automatically placed in the **Auth Token** field on the left
  </Step>

  <Step title="Customize Your Display">
    **Screen Selection (Optional):** To display only a specific part of your dashboard, you can use our Chrome Extension to select an area.

    <Info>
      Learn how to install and use the extension here: [How to Use the Dashboard Screen Mapper Chrome Extension](#)
    </Info>

    Configure the following settings:

    * **Refresh Interval:** Set how often the app should take a new screenshot of the dashboard
    * **Session Expiry:** Set how often the app should perform a full, fresh login
    * **Scrolling:** For tall dashboards, enable auto-scrolling to ensure all content is visible over time
  </Step>

  <Step title="Create and Preview the App">
    * Once the configuration is complete, click **Create App**
    * Navigate to the **Media** section of your console to find the app you just created
    * Click the thumbnail to preview the dashboard
  </Step>
</Steps>

***

## Part 3: Find Your Specific App Guide

While the process above is universal, the authentication fields in **Step 2** are unique to each service. For a detailed, step-by-step walkthrough with the exact field names for your chosen application, please select from the list below:

### Dashboards Requiring 2-Factor Authentication (2FA):

<CardGroup cols={2}>
  <Card title="Jira Dashboard" icon="jira" href="/apps/dashboard-apps/jira">
    Display your Jira dashboards with 2FA authentication
  </Card>

  <Card title="Trello Board" icon="trello" href="/apps/dashboard-apps/trello">
    Show Trello boards on your screens
  </Card>

  <Card title="Power BI Dashboard" icon="chart-line" href="/apps/dashboard-apps/power-bi">
    Visualize Power BI dashboards on digital signage
  </Card>

  <Card title="Salesforce Dashboard" icon="salesforce" href="/apps/dashboard-apps/salesforce">
    Display Salesforce analytics and dashboards
  </Card>

  <Card title="Zendesk Dashboard" icon="headset" href="/apps/dashboard-apps/zendesk">
    Show Zendesk support metrics
  </Card>
</CardGroup>

### Dashboards Without a 2FA Requirement:

<CardGroup cols={2}>
  <Card title="AWS CloudWatch Dashboard" icon="aws" href="/apps/dashboard-apps/aws-cloudwatch">
    Monitor AWS infrastructure on screens
  </Card>

  <Card title="Tableau Dashboard" icon="chart-bar" href="/apps/dashboard-apps/tableau">
    Display Tableau visualizations
  </Card>

  <Card title="Grafana Dashboard" icon="chart-area" href="/apps/dashboard-apps/grafana">
    Show Grafana monitoring dashboards
  </Card>

  <Card title="Sentry Dashboard" icon="bug" href="/apps/dashboard-apps/sentry">
    Display error tracking dashboards
  </Card>

  <Card title="Public Website" icon="globe" href="/apps/dashboard-apps/public-website">
    Show any public website
  </Card>
</CardGroup>

***

## Troubleshooting & Common Issues

<AccordionGroup>
  <Accordion title="I see the login page in the preview, not my dashboard">
    This almost always means one of the credentials you entered is incorrect. Please double-check the URLs, email, password, and especially the 2FA Secret Key, then generate a new Auth Token.
  </Accordion>

  <Accordion title="The preview is taking a long time to load">
    It may take a minute or two for the first screenshot to generate, especially for complex dashboards. Please be patient. If it doesn't load after 5 minutes, please re-check your credentials.
  </Accordion>

  <Accordion title="Can I use 'Sign in with Google/Microsoft'?">
    No. This integration requires a direct login with an email and password. Federated login methods (SSO) are not compatible with this setup.
  </Accordion>
</AccordionGroup>

***

## What's Next?

<Note>
  Once your Dashboard App is created and previewing correctly, you are ready to display it. For further reading:

  * To create a multi-zone layout: Learn about [Compositions](/compositions/compositions)
  * To send it to your screens: Learn how to [Publish or Schedule Content](/schedule-and-publish/publish-overview)
</Note>