/xibo-docker

Xibo Docker

GNU Affero General Public License v3.0AGPL-3.0

Xibo Docker

Docker is an application to package and run any application in a pre-configured container making it much easier to deploy a Xibo CMS with recommended configuration.

This repository holds the docker container definitions for Xibo and the docker-compose configuration, which is used to bootstrap, start, stop and destroy the installation.

Installation

Full installation instructions for supported use of these containers can be found in the Xibo Manual

Directory structure

This repository contains Docker configuration (Dockerfile) for the Xibo containers. A normal installation only requires docker-compose.yaml and a config.env.template file, suitably configured, saved as config.env.

/containers

web and xmr Dockerfiles and associated configuration. These are built by Docker Hub and packaged into xibosignage/xibo-cms and xibosignage/xibo-xmr.

DATA_DIR/shared

Data folders for the Xibo installation.

  • The Library storage can be found in /shared/cms/library
  • The database storage can be found in /shared/db
  • Automated daily database backups can be found in /shared/backup
  • Custom themes should be placed in /shared/cms/web/theme/custom
  • Custom modules should be placed in /shared/cms/custom
  • Any user generated PHP or resources external to Xibo that you want hosted on the same webserver go in /shared/cms/web/userscripts. They will then be available to you at http://localhost/userscripts/

Running without docker-compose

If you have your own docker environment you may want to run without the automation provided by docker-compose. If this is the case you will be responsible for pulling the docker containers, starting them and manually installing Xibo.

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.