minzords / itsmng-docker

Docker implementation of itsmng application

ITSM-NG is a GLPI fork with the objective of offering a strong community component and relevant technological choices.

Some Links

• Website
• Github
• Wiki

How to use ITSM-NG image

Run an ITSM-NG instance

Standalone

Before run ITSM-NG instance, please refer to the MariaDB docker documentation to create your own database container.

To start application instance with the latest version :

podman run \
--name [MY_CONTAINER_NAME] \
-e MARIADB_HOST=[DB_HOST] \
-e MARIADB_DATABASE=[DB_NAME] \
-e MARIAD_USER=[DB_USER] \
-e MARIADB_PASSWORD=[DB_PASSWORD] \
-idt docker.io/itsmng/itsm-ng:latest

Stack

We have a podman-compose example in every folder for each tag of our image.

To get these examples / templates, clone our git repository :

git clone https://github.com/itsmng/itsmng-docker

To start the ITSM-NG application stack, run the following command :

podman-compose up -d

By default, volume names use the current version as a prefix (i.e. 1.3.0 => 130_volumename). You can set a custom prefix with the next command :

podman-compose -p MY_PREFIX up -d

You can check if containers are running correctly with the next command :

podman container ls

The container status is Up if it works.

Now, your ITSM-NG application is available at the following address http://localhost:8080.

Environment variables

You will find below the list of all available environments variables for our docker image.

Variable	Description
MARIADB_HOST	Used to define the database hostname
MARIADB_USER	Used to define the database username
MARIADB_PASSWORD	Used to define the database user password
MARIADB_DATABASE	Used to define the database name

Volumes information

Below you will find the volumes list created by ITSM-NG docker application and their description :

Volume	Description
itsmng-config	It contains the application configuration
itsmng-plugins	It contains the application plugins
itsmng-files	It contains the application extra data (logs, cache, attachment)
itsmng-data	It contains the MariaDB instance data

Docker-compose.yml sample

version: '3'
services:
  itsmweb :
    image : docker.io/itsmng/itsm-ng:1.5.1
    depends_on:
      - itsmdb
    container_name : itsmweb
    restart: always
    ports :
      - "8080:80"
    volumes :
      - itsmng-config:/var/www/itsm-ng/config
      - itsmng-plugins:/var/www/itsm-ng/plugins
      - itsmng-files:/var/www/itsm-ng/files
    environment:
      MARIADB_HOST : itsmdb
      MARIADB_USER : itsmng
      MARIADB_PASSWORD : itsmng
      MARIADB_DATABASE : itsmng
  itsmdb :
    image: docker.io/mariadb:10.6
    container_name: itsmdb
    command: --default-authentication-plugin=mysql_native_password
    restart: always
    volumes :
      - itsmng-data:/var/lib/mysql
    environment:
      MARIADB_AUTO_UPGRADE: "yes"
      MARIADB_ALLOW_EMPTY_ROOT_PASSWORD: "yes"
      MYSQL_ROOT_PASSWORD: iamastrongpassword
      MARIADB_USER : itsmng
      MARIADB_PASSWORD : itsmng
      MARIADB_DATABASE : itsmng

volumes:
  itsmng-config:
  itsmng-plugins:
  itsmng-files:
  itsmng-data:

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Add your changes: git add folder/file1.php
4. Commit your changes: git commit -m 'Add some feature'
5. Push to the branch: git push origin my-new-feature
6. Submit a pull request !

License

ITSM-NG Docker Image is GPLv3 licensed