Introduction

Xibo - Digital Signage - https://xibo.org.uk Copyright (C) 2006-2018 Spring Signage Ltd and Contributors.

Branches

• develop: Work in progress toward 2.0
• master: Currently 1.8
• release18: Work in progress toward the next 1.8
• release17: Work in progress toward the next 1.7
• release1.6.4: Archive of 1.6

Licence

Xibo is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

Xibo is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with Xibo. If not, see http://www.gnu.org/licenses/.

Installation

Installing an official release is described in the manual and in the release notes of each release.

Developing

Please only install a Development environment if you intend make code changes to Xibo. Installing from the repository is not suitable for a production installation.

Xibo uses Docker to ensure all contributers have a repeatable development environment which is easy to get up and running.

The very same Docker containers are used in our recommended end user installation to promote consistency from development to deployment.

To these ends this repository includes a docker-compose.yml file to spin up a model development environment.

Prerequisites

The development Docker containers do not automatically build vendor files for PHP or JS, this is left as a developer responsibility. Therefore you will need the following tools:

• Git
• Composer
• NPM (coming in 2.0)
• Docker

Clone the repository

Create a folder in your development workspace and clone the repository. If you intend to make changes and submit pull requests please Fork us first and create a new branch.

git clone git@github.com:<your_id>/xibo-cms.git xibo-cms

Install dependencies

Change into your new folder

cd xibo-cms

Install the external dependencies with Composer. Your local machine is unlikely to have the necessary dependencies to install the packages, hence the --ignore-platform-reqs switch.

php composer.phar install --ignore-platform-reqs

Note, on some distributions, such as Ubuntu, composer may be availabe in the distribution's software repositories. In this case, the command listed above may be different. For example, on Ubuntu 18.04, you would use the following two commands to install composer and then run the equivalent of php composer.phar install --ignore-platform-reqs:

sudo apt install composer
composer install --ignore-platform-reqs

Bring up the Containers

Use Docker Compose to bring up the containers.

docker-compose up --build -d

Installation Wizard

Visit Xibo in the browser and follow the installation instructions. The CMS will be accessible at localhost. When asked for a database you should select to create a new database and enter these details:

• Host: mysql
• Admin User: root
• Admin Password: root

When asked for a library location you should enter

• /var/www/cms/library

Package manager ( npm ) and module bundler ( webpack )

Configure NPM Package Manager (https://www.npmjs.com/) and build dist folder with Webpack (https://webpack.js.org/):

• Install Node.js ( comes with NPM ) from https://nodejs.org/en/

• Update NPM to latest version:

npm install npm@latest -g

• Install the dependencies in the local node_modules folder:

npm install

• Build the dist folder with:

npm run build

Under the hood

Vagrant has created a virtual machine, installed Docker on it and then provisioned 3 Docker containers for Xibo to use. There is a container for the CMS web server, a container for the mysql database and a container for XMR.

Your cloned repository is mapped into the Vagrant VM under /data/web and the Docker container mounts this as /var/www/xibo. Changes you make to the source code on your host machine are immediately reflected in the nested VM and Docker container.

Database data is maintained in the guest VM and is persisted when the VM is power cycled (vagrant halt / vagrant up). For convenience the Docker MySQL container exposes mysql on port 3306 to the Vagrant VM. You can therefore connect to MySQL over SSH using 127.0.0.1 and the port/key file shown by vagrant ssh-config.

Application Structure

To find out more about the application code and how everything fits together, please refer to the advanced section of the manual.

Contributing

The standard licence for Xibo is the AGPLv3. For more information please see CONTRIBUTING.md.

Reporting Problems

Support requests can be reported on the Xibo Community Forum. Verified, re-producable bugs with this repository can be reported in the Xibo parent repository.