Xibo on a Web server

It is possible to install Xibo without using Docker, this is referred to as a Manual or Custom installation, however, a working knowledge of how to install, configure and maintain a web server is recommended.

Please note: As Docker is our supported method of running Xibo it may not be possible for us to provide the assistance you need without opening a ‘paid support’ incident.


Xibo requires:

  • MySQL 5.6
  • A web server (nginx, apache, iis)
  • PHP 7.2.9+ (see php version below)
  • PHP-CLI 7.2.9+ (see php version below)
  • URL Rewriting
  • Virtual Hosts or dedicated web server (modify DocumentRoot)
  • CRON/Scheduled Tasks

PHP version:

  • The current stable release requires PHP 7.2.9 or later.
  • PHP 7.0.8 or later can be used from Xibo 1.8.5.
  • PHP 5.6 or later can be used until Xibo 2.2.0.
  • PHP 8 is not supported.

PHP modules:

  • PHAR
  • JSON
  • GD
  • DOM
  • PDO
  • Zip
  • gettext
  • Soap
  • Curl
  • Iconv
  • Ctype
  • File Info
  • XML
  • SimpleXML
  • Mbstring
  • zlib
  • ZeroMQ

We have explained some common environment configurations in ‘Prepare your Environment’ which can be selected from the left-hand menu.

Release Download

The latest release can be downloaded from the release archives page on GitHub.

Community Guides

Please see the following guides for installing Xibo in specific environments.

A special thank you to the members of our Community who have written the following guides:

Please note: as these guides are community contributed they should be considered as guidance only:


Beyond this point, it is assumed that a web server running with PHP and MySQL is available and that the compressed archive (ZIP or Tarball) of the CMS installation package has been transferred to the server.

The installation process is:

  1. Download and extract the archive
  2. Starting the Installation
  3. Pre-requisites
  4. Creating the database
  5. Database details
  6. Starting the Installation
  7. Final Configuration
  8. Install XMR
  9. Configure XTR
  10. Complete

Download and extract the archive

The CMS archive contains a subfolder called Xibo-cms-(version), the contents of this folder should be copied into an appropriate location on your web server. It is strongly recommended that the folder is extracted in a non-webservable location. On a dedicated server the DocumentRoot should point to /path/to/Xibo]-folder/web . Other configurations are discussed on the Prepare your Environment page.

The extracted archive should look like the below screenshot:

A folder is provided for the Xibo library which will be used to store images, videos and other files. This folder can be moved to another location and changed during the install process.

Starting the Installation

Navigating to http://localhost will automatically start the installation.

The installation is in a wizard format that contains 6 steps in total. The wizard will guide the installer through the process of installing Xibo.

Step 1 - Pre-requisites

The installer contains a detailed checklist of all the items required for a successful installation. Each item will have either:

  • A tick - the item is present and correct
  • An exclamation mark - the item is present but may not be configured correctly.
  • A cross - the item is missing.

Any items with an exclamation mark or a cross should be addressed and the retest button used to run this step again.

![install_cms_step1|463x500](upload://m4H79EIcbaBogkYMAHqthe X96rBVcF.png)

The most common problems here are missing PHP modules, configuration of PHP settings and file permissions issues to the library.

Once all the items are ticked press next to advance.

Creating the database

The CMS can install into a new database or an existing one. We recommend a new database.

Xibo does not prefix its table names and may conflict with content in an existing database.

The choice for a new or existing database can be made by switching between the two available tabs.

Database Details

Whether you chose an existing database or a new one, the installer will need to collect some information about that database to allow the CMS to connect, read and write.

The installer will need the following information:

Host The hostname for your MySQL installation - in the majority of cases this will be “localhost”.

Admin Username The “root” username for your MySQL installation. This is only used for the installation and is only required if you have asked the installer to create a new database.

Admin Password The “root” password. This is only used for the installation and is only required if you have asked the installer to create a new database.

Database Name The name for the CMS database.

Database Username The username for the CMS to use to connect to the database - usually this can be the same.

Database Password The password to use to connect to the database.

Start the Installation

The installer will now create/populate the database for Xibo. You should see a series of dots appear on the screen as this happens. It can take a few moments to complete. Assuming everything went well, click “Next”.

If there are errors at this point, please see the Troubleshooting Section.

Admin Password

Each installation will require at least one “Super User” level Administrator to manage the system, apply upgrades and configure the advanced settings. The installer will prompt for the creation of this user at Step 3.

This username and password should be kept safe as it will be required when the installation is complete.


The next screen deals with configuring Xibo. The first box asks for the location that Xibo should store the media you upload. The release archive included a folder for this, /library or a different folder can be used. Enter that folder here e.g /var/www/Xibo/library .

The next box asks for a CMS key - this key is used to authenticate Displays with the CMS and should be something obscure.

The final tick box asks if it’s OK to send anonymous statistics back to the Xibo project. We would be very happy if you did!


The installation is now complete and the system is ready to log in.



XMR is the push messaging engine in Xibo and it is recommended to have XMR running for all installations.

XTR is the task runner and should be configured for all installations.

Installation and configuration instructions are available from the left-hand menu.