emoneth/traccar-docker repository overview

⁠Traccar in Docker

Traccar GPS Tracking System in Docker image.

Official website: https://www.traccar.org⁠

⁠Available tags:

• 4.8-alpine, 4-alpine, 4.8, alpine, latest
• 4.8-debian, 4-debian, debian
• 4.7-alpine, 4.7
• 4.7-debian
• 4.6-alpine, 4.6
• 4.6-debian
• 4.5-alpine, 4.5
• 4.5-debian
• 4.4-alpine, 4.4
• 4.4-debian
• 4.3-alpine, 4.3
• 4.3-debian
• 4.2-alpine, 4.2
• 4.2-debian
• 4.1-alpine, 4.1
• 4.1-debian
• 4.0-alpine, 4.0
• 4.0-debian
• 3.17-alpine, 3.17
• 3.17-debian
• 3.16-alpine, 3.16
• 3.16-debian

⁠Container create example:

1. Create work directories:

   mkdir -p /var/docker/traccar/logs
   

   Copy

2. Get default traccar.xml:

   docker run \
   --rm \
   --entrypoint cat \
   traccar/traccar:latest \
   /opt/traccar/conf/traccar.xml > /var/docker/traccar/traccar.xml
   

   Copy

3. Edit traccar.xml: https://www.traccar.org/configuration-file/⁠

4. Create container:

   docker run \
   -d --restart always \
   --name traccar \
   --hostname traccar \
   -p 80:8082 \
   -p 5000-5150:5000-5150 \
   -p 5000-5150:5000-5150/udp \
   -v /var/docker/traccar/logs:/opt/traccar/logs:rw \
   -v /var/docker/traccar/traccar.xml:/opt/traccar/conf/traccar.xml:ro \
   traccar/traccar:latest
   

   Copy

⁠Database

The default when executing the above docker run command is an internal H2 database but this should only be for basic use.

The docker run command also doesn't create a mount point on the host for the data folder which will cause the database to be lost when the container is recreated. This point can be mitigated by adding the line -v /var/docker/traccar/data:/opt/traccar/data:rw \ after -v /var/docker/traccar/traccar.xml:/opt/traccar/conf/traccar.xml:ro \ but it will still be using the H2 database.

The recommended solution for production use is to link to an external MySQL database and update the configuration .xml file according to the Traccar MySQL documentation⁠ and using the docker run command as-is.

⁠Default JVM options:

• -Xms512m
• -Xmx512m
• -Djava.net.preferIPv4Stack=true