GLPI Docker Container

Supported tags

• 9.5.6, 9.5, 9, latest
• unstable

Quick reference

• Where to file issues: https://github.com/PPCM/docker-glpi/issues

• Supported architectures: (more info) amd64 arm arm64

What is GLPI

GLPI is an incredible ITSM software tool that helps you plan and manage IT changes in an easy way, solve problems efficiently when they emerge and allow you to gain legitimate control over your company’s IT budget, and expenses.

About this image

This image contains GLPI with:

• OS: Alpine
• Web Server: Apache2 / PHP
• Following plugins are installed in this package:
  • Account
  • Addressing
  • Fields
  • Fusion Inventory
  • Manageentities
  • Manufacturesimports
  • More reporting GLPI plugin
  • News GLPI plugin
  • Additional Reports

How to use this image

Start a GLPI server instance

Starting a GLPI instance is simple

$ docker network create some-network 
$ docker run -d --name some-mariadb -p 3306:3306 --network some-network -e MARIADB_USER=glpi-user -e MARIADB_PASSWORD=glpi-password -e MARIADB_ROOT_PASSWORD=root-password -e MARIADB_DATABASE=glpi -v mysql-dir:/var/lib/mysql mariadb:latest
$ docker run -d --name some-glpi -p 8089:80 --network some-network -e TZ="Europe/Paris" -v glpi-config:/var/www/glpi/config -v glpi-files:/var/www/glpi/files -v glpi-plugins:/var/www/glpi/plugins -v glpi-marketplace:/var/www/glpi/marketplace ppcm/glpi:latest
$ docker run -d --name some-glpi-cron --network some-network -e MYSQL_HOST=some-mariadb -e MYSQL_PORT=3306 -e MYSQL_ROOT_PASSWORD=root-password -e MYSQL_USER=glpi-user -e MYSQL_PASSWORD=glpi-password -e MYSQL_DATABASE=glpi -e LANG=fr_FR -e TZ="Europe/Paris" -v glpi-config:/var/www/glpi/config -v glpi-files:/var/www/glpi/files -v glpi-plugins:/var/www/glpi/plugins -v glpi-marketplace:/var/www/glpi/marketplace ppcm/glpi-cron:latest

Docker informations

Exposed ports

Port	Usage
80/tcp	HTTP web application

For SSL, there are many different possibilities to introduce encryption depending on your setup.

As most of available docker image on the internet, it is recommend using a reverse proxy in front of this image. This prevent to introduce all ssl configurations parameters and also to prevent a limitation of the available parameters.

For example, you can use the popular nginx-proxy and docker-letsencrypt-nginx-proxy-companion containers or Traefik to handle this.

Environments variables

Environment	Default	Usage
MYSQL_HOST		MANDATORY - MySQL or MariaDB host name
MYSQL_PORT	3306	MySQL or MariaDB host port
MYSQL_ROOT_PASSWORD		MySQL or MariaDB root password, it is needed to create database and user. It is also needed to configure properly the user. It can be set only on first start of the applkcation.
MYSQL_USER	glpi-user	MySQL or MariaDB GLPI username
MYSQL_PASSWORD	glpi-password	MySQL or MariaDB password for GLPI user
MYSQL_DATABASE	glpi	MySQL or MariaDB database name for GLPI
LANG	fr_FR	Default language of GLPI
TZ	Europe/Paris	Timezone of the web server

Exposed volumes

Volume	Usage
/var/www/glpi/config	The configuration path of GLPI
/var/www/glpi/files	The path for stored files in GLPI
/var/www/glpi/plugins	The path for plugins in GLPI
/var/www/glpi/marketplace	The path for plugins downloaded from the GLPI marketplace

GLPI Cronjob

GLPI require a job to be run periodically. To respect docker convention and to prevent a clustered deploiement to run the cron on all cluster instances, the cron task was removed from GLPI main image.

As compensation a dedicated image was made for the cron task. Only one instance of this image have to run on your cluster.