ligero/otrs-itsm repository overview

⁠OTRS Docker Installation

⁠Default OTRS username and password of this Image

Username: root@localhost Password: ligero

⁠What's OTRS?

OTRS is the world most popular Service Desk software, delivered by OTRS Group and a large open source community. You can check more information and all OTRS Group Services in their web site: http://www.otrs.com⁠

This Docker image is maintained by Complemento, a Brazilian company dedicate to delivery ITSM with open source software. We develop many Free and Enterprise AddOns for OTRS. You can check our website for more information: http://complemento.net.br⁠

⁠About this Image

This image aims to make a fresh new application install of OTRS. You will need to create another MySQL container for your own or use our docker-compose file.

⁠Running this Image

You can run this image in 2 different ways: with docker-compose, creating a stack with OTRS and MySQL with a default installation done, or without docker-compose, running a standalone container and finishing OTRS installation through it's web interface by your own.

First of all, please Install your docker server in case you haven't done yet. You can download Docker Community Edition from this link: https://www.docker.com/community-edition#/download⁠

Now, choose the way you want to run this image:

⁠Using docker-compose

If you choose this way, please make sure you have installed docker-compose: https://docs.docker.com/compose/install/#install-compose⁠

Download the docker-compose.yaml file from our github, to some folder of your preference.

https://github.com/LigeroSmart/ligerosmart-stack⁠

• The ITSM Bundle, Survey and FAQ packages are default, and downloaded inside Dockerfile commands

Run your Stack with:

docker-compose up -d

Then you can check if the system could start by it self:

docker-compose logs -f web

When you see this message on the log: INFO success: apache2 entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)

It's because the system is running and you can access it.

You can discover the container IP using the following command:

docker-compose exec web ip a

And then you can access the system in your web browser:

http://CONTAINER_IP/otrs/index.pl

Username: root@localhost Password: ligero

⁠Docker-compose Variables

You can edit your docker-compose.yaml and adapt to your reallity

⁠Standalone container

If you just want to run a docker container with our OTRS 6 flavor, follow these steps:

1. Run the following command:

docker run -d --name my_otrs_container -p 80:80 ligero/otrs-itsm

Then you can check if the system could start by it self:

docker logs -f my_otrs_container

When you see this message on the log: INFO success: apache2 entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)

It's because the system is running and you can access it.

You can finish the installation through the following address:

http://localhost/otrs/installer.pl⁠ (if you set -p 80:80) or http://YOUR_CONTAINER_IP/otrs/installer.pl

You can discover the container IP using the following command:

docker exec my_otrs_container ip a

⁠Other settings

You can use OTRS's SMTP protocols for sending emails. This image also contains a sendmail service since it's the recommended way to send emails in OTRS production systems.

If you want to use it instead of OTRS's SMTP protocols, you may map a /etc/mail with sendmail configurations (this is for experts), or access the container and make your own sendmail configuration.

⁠AddOns Installation

You can map a volume with the addons you want to install during the container startup:

docker run -d --name sd_otrs_app \
-v $(pwd)/app-packages:/app-packages \
ligero/otrs-itsm

⁠AddOns installed on first run

• GeneralCatalog
• ITSM Bundle
• FAQ
• Survey