Serveur Minecraft : l'héberger avec Docker

Ce guide suit la documentation de l'image, relue le 14 octobre 2026. L'image n'est pas publiée par Mojang : c'est un projet libre qui automatise l'installation du serveur officiel. Il faut Docker Engine et son extension Compose.

Installer le serveur

1. Créez un dossier et placez-vous dedans : mkdir ~/minecraft && cd ~/minecraft
2. Créez le fichier compose.yaml ci-dessous.
3. Lancez : docker compose up -d
4. Suivez le premier démarrage, qui télécharge le serveur et génère le monde : docker compose logs -f

services:
  mc:
    image: itzg/minecraft-server:latest
    container_name: mc
    pull_policy: daily
    tty: true
    stdin_open: true
    restart: unless-stopped
    ports:
      - "25565:25565"
    environment:
      EULA: "TRUE"
      MEMORY: "2G"
      DIFFICULTY: "normal"
      MOTD: "Notre serveur Minecraft"
      WHITELIST: |
        pseudo1
        pseudo2
      OPS: pseudo1
    volumes:
      - ./data:/data

EULA: "TRUE" signifie que vous acceptez le contrat de licence de Minecraft : lisez-le avant. L'étiquette latest de l'image, avec pull_policy: daily, suit les mises à jour de l'image ; sans autre réglage, le serveur télécharge au démarrage la dernière version stable de Minecraft Java Edition, d'après la documentation.

Régler la mémoire

MEMORY fixe la mémoire du programme Java du serveur, 1 Go par défaut, d'après la page sur les options de Java. Le serveur consomme un peu plus que cette valeur : la documentation conseille d'ajouter une marge d'environ 25 % pour le reste. Augmentez MEMORY si le jeu ralentit avec plusieurs joueurs connectés, en laissant de la place au système et aux autres conteneurs. docker stats montre la mémoire réellement utilisée. Si le serveur fait tourner d'autres applications gourmandes, comme un modèle d'IA avec Ollama, additionnez leurs besoins.

Choisir qui peut jouer

La page des propriétés du serveur décrit les variables utiles :

Avec une liste blanche, un inconnu qui trouve l'adresse ne peut pas entrer. Les pseudos sont ceux des profils Java Edition, pas des gamertags Xbox, précise la documentation. Après un changement dans compose.yaml, appliquez-le avec docker compose up -d.

Envoyer des commandes au serveur

La console accepte les commandes de Minecraft. D'après la page sur l'envoi de commandes :

1. Console interactive : docker exec -i mc rcon-cli
2. Commande isolée : docker exec mc rcon-cli say Redémarrage dans 5 minutes
3. Arrêt propre du serveur : docker exec mc rcon-cli stop

Sauvegarder le monde

Le monde et la configuration vivent dans le dossier data, à côté du fichier compose. Pour une copie cohérente, arrêtez le serveur (docker compose stop), copiez le dossier, puis relancez (docker compose start). Gardez les copies hors du serveur ; pour les planifier, voir Planifier une tâche avec cron.

Sur un VPS Hubspace

Docker et Compose sont installés à la livraison, et le compte admin les utilise sans sudo. Le port 25565 est fermé à la livraison, même publié par Docker : seuls 22, 80 et 443 sont ouverts depuis Internet. Ajoutez une règle entrante TCP 25565 dans l'onglet « Firewalls » de l'espace client, comme le montre Ouvrir un port sur son VPS. Les joueurs se connectent ensuite avec l'adresse IP du serveur, ou un nom de domaine qui pointe vers elle. Le disque principal est sauvegardé chaque jour, avec sept jours de conservation, ce qui ne remplace pas vos copies du monde. Les tailles et leur mémoire sont sur la page des serveurs VPS.

Questions fréquentes