> ## 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 install the Pickcel digital signage software on a Linux player?

> Follow this simple procedure to install the Pickcel Software on your Linux device from the Pickcel Website

<Note>
  Supported on Ubuntu 18 and above.
</Note>

<Info>
  **Considerations for Physical setup:**

  * Linux system (Ubuntu 18 or above).
  * Active internet connection.
</Info>

<Steps>
  <Step title="Download DEB File">
    Download the latest DEB file: [Download the Linux player (v3.4.3)](https://console.pickcel.com/players/linux/pickcel-digital-signage_v3.4.3.deb)

    <Note>
      You can also visit the [Pickcel Download Page](https://www.pickcel.com/download/#linux) directly and **download the latest DEB file** from the **Linux** section.
    </Note>
  </Step>

  <Step title="Locate the Downloaded File">
    Navigate to the **Downloads** folder on your device and **double-click** on the downloaded file.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Linux/Screenshot from 2025-10-27 16-30-51.TWFCpmnmUqQV.png" alt="Locate Downloaded File" />
    </Frame>
  </Step>

  <Step title="Install the Package">
    Click on **Install** and authenticate with your password to begin the installation.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/player-installation/linux/01-click-install.9qW163lMx9HS.png" alt="Click Install" />
    </Frame>
  </Step>

  <Step title="Launch the Application">
    After installation, type **Pickcel** in Dash, and launch the Pickcel application from there.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Linux/shot_F_16-11-58.xQDU9ij8FfMt.png" alt="Launch Pickcel from Dash" />
    </Frame>
  </Step>

  <Step title="View Registration Code">
    Once the app is launched, it will show a 6-digit alphanumeric Screen Registration Code.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/player-installation/linux/02-registration-code.SDcCdIHMhsyS.png" alt="Registration Code" />
    </Frame>
  </Step>

  <Step title="Pair with Pickcel Console">
    Pair your display with the Pickcel console using the registration code. You will have to enter this code on your [Pickcel console](https://console.pickcel.com/) to complete the pairing of your screen.

    <Info>
      To learn how to pair your device with the Pickcel console, see the [Screen Registration guide](/screen-registration/screen-registration)
    </Info>
  </Step>
</Steps>

The installation of the Pickcel digital signage software on your Linux device is complete, and you can start publishing content to your screens now.

## How to Enable Automatic Startup (Optional)

To automatically launch the Pickcel app at system startup, follow these steps:

<Steps>
  <Step title="Open Startup Applications">
    Open **Startup Applications** on your system.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Linux/linux-9.rARXvvkOYhtW.jpg" alt="Open Startup Applications" />
    </Frame>
  </Step>

  <Step title="Add New Startup Entry">
    In the Startup Applications window, click on the **Add** button.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Linux/linux-10.1Mng01es0POe.jpg" alt="Click Add Button" />
    </Frame>
  </Step>

  <Step title="Find the Application Path">
    To add the application to the startup list, you need to find the command that runs it. Open the terminal and type the following command:

    ```bash theme={null}
    which pickcel-digital-signage
    ```

    Press <kbd>**Enter**</kbd> to execute.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Linux/linux-11.uR2BQZw9BKW8.jpg" alt="Terminal Command" />
    </Frame>
  </Step>

  <Step title="Copy the Application Path">
    The `which` command locates the executable file and displays its full path. The terminal will display the complete path where the Pickcel application is installed (typically `/usr/bin/pickcel-digital-signage`). Copy this path - you'll need it in the next step.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Linux/linux-12.8g_BNB9mvjZ7.jpg" alt="Application Path" />
    </Frame>
  </Step>

  <Step title="Configure Startup Entry">
    In the Add Startup Program window, fill in the following details:

    * **Name**: Enter a user-friendly name for the program (e.g., "Pickcel Digital Signage")
    * **Command**: Enter `/usr/bin/pickcel-digital-signage`

    Click on the **Add** button to save.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/apps/Linux/linux-13.EcCYRS0klrkm.jpg" alt="Add Startup Entry" />
    </Frame>
  </Step>

  <Step title="Restart Your System">
    Close the Startup Applications window and restart your system. The Pickcel app will launch automatically after boot.
  </Step>
</Steps>

<Note>
  **What's Next?**

  Now that your Linux player is installed, complete your setup:

  * Start [**Uploading Media**](/media/add-media) to your library
  * Create your first [**Composition**](/compositions/compositions) and publish content
</Note>