This repository is out of date. See LigeroSmart/ligerosmart, a fork of the OTRS project.
Username: root@localhost Password: ligero
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://www.complemento.net.br
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.
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:
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.
Let's suppose you want to put it under /opt/containers/otrs:
mkdir -p /opt/containers/otrs
cd /opt/containers/otrs
wget https://raw.githubusercontent.com/complemento/docker.otrs/master/docker-compose.yaml
If you want to install AddOns during the Stack startup, you can create an otrs_addons folder under this directory and put the AddOns there. For example, if you want to install FAQ and OTRS ITSM:
mkdir otrs_addons
cd otrs_addons
wget ftp://ftp.otrs.org/pub/otrs/itsm/bundle6/ITSM-6.0.9.opm
wget ftp://ftp.otrs.org/pub/otrs/packages/FAQ-6.0.8.opm
Then go back to the stack folder:
cd /opt/containers/otrs
And finally, run your Stack!
docker-compose up -d
Then you can check if the system could start by it self:
docker-compose logs -f otrs
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 otrs ip a
And then you can access the system in your web browser:
http://CONTAINER_IP/otrs/index.pl
Username: root@localhost Password: ligero
You can edit your docker-compose.yaml and adapt to your reallity
| VARIABLE | Default | DESCRIPTION |
|---|---|---|
| CUSTOMER_ID | ligero | Used for setting database name and other options |
| OTRS_SYSTEM_ID | 10 | SystemID of OTRS |
| OTRS_DEFAULT_LANGUAGE | en | Default Language: en, pt_BR etc |
| OTRS_FQDN | myotrs.ligero.online | Used for composing several system notifications. You can change it latter under the sysconfig, or set it here before running the stack |
| INSTALL | 1 | Marked for installing the database and initial setup in a stack (docker-compose) installation |
| DONT_INSTALL_LIGERO_ADDONS | 0 | Set to 1 if you do not want to install Ligero Repository. Our Repository give you access to several free and enterprise AddOns for improving your experience with OTRS |
If you just want to run a docker container with our OTRS 6 flavor, follow these steps:
- Run the following command:
docker run -d --name my_otrs_container -p 80:80 ligero/otrs
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
A more complex way of running this image:
docker run -d --name sd_otrs_app \
-v /opt/docker/ServiceDesk/app/mail/:/etc/mail \
-v /opt/docker/ServiceDesk/app/otrs:/opt/otrs \
-v /usr/share/zoneinfo/America/Sao_Paulo:/etc/localtime:ro \
-P --network=ligero_complemento ligero/otrs
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.
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)/my_local_addons_folder:/opt/otrs_addons \
ligero/otrs