> For the complete documentation index, see [llms.txt](https://docs.xibosignage.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xibosignage.com/setup-docs/open-source-player-apps/xibo-for-linux-installation.md).

# Linux Player Installation

The Linux Player app is released as a snap package, distributed via the Snap Store, which will provide updates to the Player.

## Minimum Requirements

* Linux: Ubuntu LTS, x86-64 (for other Debian based distributions, ensure that they are piloted before an estate rollout)
* Windows: 64-bit
* Architecture: x86-64 only
* Intel Core i3 or AMD equivalent, 8GB RAM, integrated graphics, 128GB SSD
* Commercial-grade hardware rated for 24/7 operation
* Minimum CMS version 4.5.2
* Outbound HTTPS to the CMS, and a web socket connection to XMR
* Inbound on the embedded server port (default 9696), localhost only unless WAN access is explicitly enabled in the display settings profile

{% hint style="warning" %}
Installing the Linux Player App on a device that does not meet our minimum requirements will not qualify for helpdesk support when on one of our plans.
{% endhint %}

## Installing the Linux Player App

{% stepper %}
{% step %}

### Install the Player App

* Run: `snap install xibo-player --channel=stable`

Or visit: <https://snapcraft.io/xibo-player> or use the button below.

[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-white.svg)](https://snapcraft.io/xibo-player)

* select the Linux Player from the desktop/app drawer or open a terminal and run: `xibo-player`
  {% endstep %}

{% step %}

### Connect to the CMS

* Login to the CMS and navigate to the **Displays** page
* From the Displays page in the CMS, select the **Add Display** button at the top of the grid
* Enter the activation code as shown on the Player screen
* Click to **Save**

{% hint style="success" %}
The Activate Player page will automatically close once successfully connected.
{% endhint %}
{% endstep %}

{% step %}

### Authorise the Display

* From the CMS, navigate to the **Displays** page
* Use the row menu for the newly registered entry and select **Authorise**
* Click **Yes** to confirm

{% hint style="success" %}
The Display is now ready to start showing content from the Xibo CMS
{% endhint %}
{% endstep %}
{% endstepper %}

## Uninstalling

You can safely delete the files the Player created in your temporary directory, and if you want to remove the Player from your system, simply run:

```
snap remove xibo-player
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.xibosignage.com/setup-docs/open-source-player-apps/xibo-for-linux-installation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.