Mise à jour SEO (Mars 2026)

Vous voyez des timestamps incohérents ? Ce tuto montre comment aligner timezone serveur/conteneur pour fiabiliser logs, jobs et données.

Docker : comment synchroniser l'heure du serveur avec votre conteneur

Votre application affiche 14h00 alors qu'il est 16h00. Les dates de création dans votre base de données sont décalées de deux heures. Vos emails automatiques partent au mauvais moment. Le problème ne vient pas de votre code. Il vient de Docker.

Docker, en quelques mots

Docker est un outil qui permet d'empaqueter une application avec tout ce dont elle a besoin pour fonctionner : le code, les dépendances, la configuration. Le tout tourne dans un "conteneur", une sorte de boîte isolée. L'avantage : votre application se comporte de la même façon sur votre ordinateur, sur un serveur de test et en production.

Mais cette isolation a un effet secondaire. Le conteneur a sa propre horloge. Et par défaut, elle n'est pas réglée sur le même fuseau horaire que votre serveur.

Pourquoi les heures sont décalées

Par défaut, tous les conteneurs Docker utilisent le fuseau horaire UTC (Coordinated Universal Time). C'est le fuseau de référence mondial, celui de Londres en hiver.

La France est en UTC+1 (heure d'hiver) ou UTC+2 (heure d'été). Si votre serveur est configuré en heure française mais que votre conteneur reste en UTC, vous aurez un décalage d'une à deux heures sur toutes les dates et heures.

Vous pouvez le vérifier facilement :

1
docker exec -it nom_du_conteneur date

Comparez avec l'heure de votre serveur :

1
date

Si les deux ne correspondent pas, c'est bien un problème de fuseau horaire.

Solution 1 : configurer le fuseau dans le Dockerfile

Si vous construisez votre propre image Docker, ajoutez ces lignes dans votre Dockerfile :

1
ENV TZ=Europe/Paris
2
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

La première ligne définit la variable d'environnement TZ sur le fuseau horaire de Paris. La seconde crée un lien vers le bon fichier de fuseau horaire dans le conteneur.

Reconstruisez ensuite votre image :

1
docker build -t mon-application .

Puis relancez votre conteneur. L'heure devrait maintenant correspondre à l'heure française.

Solution 2 : passer par docker-compose

Si vous utilisez Docker Compose (un outil qui permet de gérer plusieurs conteneurs avec un seul fichier de configuration), vous pouvez monter le fichier de fuseau horaire du serveur directement dans le conteneur :

1
services:
2
  mon-application:
3
    image: mon-application:latest
4
    environment:
5
      - TZ=Europe/Paris
6
    volumes:
7
      - /etc/localtime:/etc/localtime:ro

Le volume /etc/localtime:/etc/localtime:ro copie la configuration horaire du serveur hôte dans le conteneur. Le :ro signifie "read-only" (lecture seule).

Quelle solution choisir ?

Le Dockerfile est préférable si vous voulez que le fuseau horaire soit toujours le même, peu importe le serveur.

Le docker-compose avec le volume est préférable si vous déployez sur plusieurs serveurs dans des fuseaux horaires différents.

Dans la plupart des cas, pour une application française hébergée en France, la solution Dockerfile est la plus simple.

Vérification

Après avoir appliqué le correctif :

1
docker exec -it nom_du_conteneur date

Vous devriez voir l'heure française. Vérifiez aussi dans votre application que les dates sont maintenant correctes.

Vous ne voulez pas gérer ces détails d'infrastructure ?

La configuration Docker, les fuseaux horaires, le déploiement, la maintenance... ce sont des sujets techniques qui prennent du temps. Chez Algomax, nous déployons et maintenons les applications de nos clients sur des infrastructures Docker. Parlons de votre projet.

Aller plus loin avec Algomax

• Développement d'agent IA sur mesure
• Création d'application SaaS
• Développement d'application mobile
• Agence IA à Strasbourg