Installation de Traccar avec Docker
Ce guide explique comment installer Traccar en utilisant Docker et Docker Compose. Cette méthode est recommandée car elle simplifie le déploiement et la gestion de Traccar et de ses dépendances.
Prérequis
- Un serveur Linux.
- Un accès root ou un utilisateur avec des privilèges
sudo. - Docker et Docker Compose installés.
Installer Docker/Docker Compose sur Ubuntu (22.04 ou plus récent)
-
Désinstaller les anciens paquets si présents :
sudo apt remove docker docker-engine docker.io containerd runc -
Installer les dépendances et ajouter la clé GPG officielle :
sudo apt update sudo apt install -y ca-certificates curl gnupg sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg -
Ajouter le dépôt Docker et installer le moteur avec le plugin Compose :
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -
Vérifier que Docker et Compose fonctionnent :
sudo docker run --rm hello-world docker compose version -
(Optionnel) Autoriser l’utilisateur courant à utiliser Docker sans
sudo:sudo usermod -aG docker $USER newgrp docker
Fichier docker-compose.yml
Le fichier docker-compose.yml à la racine de ce projet définit les services suivants :
database: Un conteneur MySQL pour stocker les données de Traccar.traccar: Le conteneur principal de Traccar.cloudflared: Un conteneur pour le tunnel Cloudflare, qui expose Traccar de manière sécurisée.autoheal: Un conteneur qui surveille et redémarre les conteneurs en mauvaise santé.
Personnalisation du docker-compose.yml
- Volumes: Les volumes sont configurés pour stocker les données de la base de données (
/opt/traccar/data) et les logs de Traccar (/opt/traccar/logs) sur l'hôte. Vous pouvez changer ces chemins si nécessaire. - Ports: Le port
8082est exposé pour l'interface web de Traccar. La plage de ports5000-5500est également exposée pour la communication avec les appareils GPS. Vous pouvez ajuster cette plage en fonction des ports requis par vos appareils.
Démarrage des conteneurs
Pour démarrer tous les services, exécutez la commande suivante à la racine du projet :
sudo docker-compose up -d
up: Crée et démarre les conteneurs.-d: Exécute les conteneurs en arrière-plan (detached mode).
Les images Docker seront téléchargées, et les conteneurs seront créés et démarrés.
Gestion des services
-
Voir les logs: Pour voir les logs de tous les services :
sudo docker-compose logs -fPour voir les logs d'un service spécifique (par exemple,
traccar) :sudo docker-compose logs -f traccar -
Arrêter les services:
sudo docker-compose down -
Redémarrer les services:
sudo docker-compose restart
Accès à l'interface Web
Une fois les conteneurs démarrés, vous pouvez accéder à l'interface web de Traccar via l'URL que vous avez configurée avec votre tunnel Cloudflare (par exemple, https://traccar.votredomaine.com).
- Identifiant par défaut:
admin - Mot de passe par défaut:
admin
Il est fortement recommandé de changer le mot de passe administrateur dès votre première connexion.
Configuration de Traccar
Avec cette configuration Docker, les paramètres de Traccar sont gérés via des variables d'environnement dans le fichier docker-compose.yml. Si vous avez besoin de modifier la configuration avancée, vous pouvez monter un fichier traccar.xml personnalisé dans le conteneur traccar en ajoutant un volume :
volumes:
- /chemin/vers/votre/traccar.xml:/opt/traccar/conf/traccar.xml
- /opt/traccar/logs:/opt/traccar/logs
Consultez la documentation officielle de Traccar pour plus d'informations sur la configuration avec Docker.