Faire tourner un serveur Minecraft avec Docker

Sur un VPS ou un serveur dédié, Docker range votre serveur Minecraft dans un conteneur : Java, Paper et leurs versions sont dans l'image, votre monde et vos plugins dans un volume. Mettre à jour, déplacer ou restaurer devient une affaire de minutes.

L'image de référence

L'image itzg/minecraft-server est la plus utilisée : elle télécharge la bonne version de Paper, Purpur, Fabric ou Forge et la bonne version de Java au démarrage, selon des variables d'environnement.

Le fichier docker-compose.yml

services:
  minecraft:
    image: itzg/minecraft-server
    restart: unless-stopped
    ports:
      - "25565:25565"
    environment:
      EULA: "TRUE"
      TYPE: "PAPER"
      VERSION: "1.21.1"
      MEMORY: "6G"
      USE_AIKAR_FLAGS: "true"
      MOTD: "Mon serveur"
      RCON_PASSWORD: "changez-ce-mot-de-passe"
    volumes:
      - ./data:/data
    tty: true
    stdin_open: true

docker compose up -d démarre le serveur ; docker compose logs -f minecraft affiche la console.

Envoyer des commandes

docker compose exec minecraft rcon-cli

Sans argument, rcon-cli ouvre une console interactive ; docker compose exec minecraft rcon-cli say Redémarrage dans 5 minutes envoie une seule commande. L'image active RCON en interne pour cet usage : ne publiez jamais son port (25575) vers l'extérieur.

Les sauvegardes automatiques

Ajoutez un second service qui sauvegarde le volume à intervalle régulier :

  sauvegardes:
    image: itzg/mc-backup
    restart: unless-stopped
    environment:
      BACKUP_INTERVAL: "6h"
      PRUNE_BACKUPS_DAYS: "7"
      RCON_HOST: minecraft
      RCON_PASSWORD: "changez-ce-mot-de-passe"
    volumes:
      - ./data:/data:ro
      - ./sauvegardes:/backups
    depends_on:
      - minecraft

Même mot de passe RCON que le serveur : c'est par là qu'il met le serveur en pause d'écriture le temps de la copie (save-off / save-on) pour une sauvegarde cohérente. Copiez régulièrement le dossier sauvegardes hors de la machine : une sauvegarde sur le même disque ne protège pas d'une panne de disque.

Mettre à jour

Épingler VERSION évite qu'un redémarrage vous fasse changer de version sans l'avoir décidé. Pour mettre à jour, changez-la, puis :

docker compose pull
docker compose up -d

Faites une sauvegarde avant, et vérifiez la compatibilité de vos plugins avec la nouvelle version : la marche à suivre complète est dans Mettre à jour son serveur sans rien casser.

Quelques conseils

• Ajustez MEMORY avec le calculateur de flags et de RAM ; laissez 1 à 2 Go au système.
• Pour plusieurs serveurs, un service par serveur et un proxy Velocity devant, dans le même fichier.
• Les fichiers de ./data appartiennent à l'utilisateur du conteneur : réglez UID et GID pour pouvoir les éditer sans sudo.