Installation et Gestion d'un Serveur StarRupture¶

Ce guide vous explique comment installer, configurer et administrer un serveur StarRupture à l'aide de Docker et Docker Compose.

StarRupture est un jeu multijoueur d'action et de survie dans l'espace, où les joueurs s'affrontent et coopèrent dans un univers galactique.

1. Prérequis¶

Avant de commencer, assurez-vous de disposer de :

Une machine sous Linux (Debian/Ubuntu recommandé)
Minimum 8 Go de RAM recommandé (le conteneur est limité à 8 Go)
Docker et Docker Compose installés — voir Installation Docker

2. Installation du Serveur StarRupture¶

2.1 Créer le répertoire du projet¶

mkdir -p /opt/docker-compose/starrupture
cd /opt/docker-compose/starrupture

2.2 Créer le fichier `docker-compose.yml`¶

services:
  starrupture:
    image: struppinet/starrupture-dedicated-server:latest
    container_name: starrupture
    restart: unless-stopped
    stop_grace_period: 30s  # Délai avant arrêt forcé (laisse le temps de sauvegarder)
    ports:
      - "7777:7777/udp"      # Gameplay UDP
      - "7777:7777/tcp"      # Gameplay TCP
      - "27015:27015/udp"    # Steam Query (découverte du serveur via Steam)
    environment:
      - SERVER_PORT=7777         # Port principal du serveur
      - USE_DSSETTINGS=true      # Charge la config depuis les fichiers .ini du serveur dédié
      - TZ=Europe/Paris          # Fuseau horaire du serveur
    volumes:
      - ./savegame:/home/container/server_files/StarRupture/Saved/SaveGames  # Sauvegardes de parties
      - ./server:/home/container/server_files                                 # Fichiers du serveur (binaires, configs)
    deploy:
      resources:
        limits:
          memory: 8G         # Limite mémoire maximale du conteneur
        reservations:
          memory: 4G         # Mémoire minimale garantie au démarrage

📌 Note :

Le répertoire savegame/ contiendra uniquement les sauvegardes de partie.

Le répertoire server/ contiendra l'ensemble des fichiers du serveur (binaires, configurations, etc.).

USE_DSSETTINGS=true active la lecture des paramètres depuis les fichiers de configuration du serveur dédié.

3. Configuration du Serveur¶

Principaux paramètres disponibles via les variables d'environnement :

Variable	Description	Valeur par défaut
`SERVER_PORT`	Port principal TCP/UDP du serveur	`7777`
`USE_DSSETTINGS`	Utilise les fichiers de config du serveur dédié	`true`
`TZ`	Fuseau horaire du serveur	`Europe/Paris`

💡 Astuce : La configuration avancée (nom du serveur, mot de passe, options de gameplay) se fait dans les fichiers présents dans server/StarRupture/Saved/Config/LinuxServer/.

▶ 4. Lancer et Gérer le Serveur¶

4.1 Démarrage¶

cd /opt/docker-compose/starrupture
docker-compose up -d

4.2 Vérification¶

docker ps

5. Commandes Utiles¶

Action	Commande
🔁 Redémarrer le serveur	`docker-compose restart`
⛔ Arrêter le serveur	`docker-compose down`
📜 Logs en direct	`docker-compose logs -f`
🐚 Accès shell conteneur	`docker exec -it starrupture /bin/bash`
🔄 Mettre à jour l'image	`docker-compose pull && docker-compose up -d`
🧼 Nettoyage complet	`docker-compose down -v --rmi all --remove-orphans`

6. Connexion au Serveur¶

6.1 Depuis le jeu¶

🎮 Lancez StarRupture, puis connectez-vous au serveur avec l'adresse :

<IP_PUBLIQUE>:7777

6.2 Ports nécessaires¶

Assurez-vous que les ports suivants sont ouverts dans votre pare-feu et redirigés via votre NAT :

7777 TCP/UDP — Connexion gameplay principale
27015 UDP — Steam Query (découverte du serveur via Steam)

7. Arborescence des fichiers¶

/opt/docker-compose/starrupture/
├── docker-compose.yml           # Fichier Docker principal
├── savegame/                    # Sauvegardes de parties
└── server/                      # Fichiers du serveur (binaires, configs)
    └── StarRupture/
        └── Saved/
            ├── Config/
            │   └── LinuxServer/ # Fichiers de configuration avancée
            └── SaveGames/       # Sauvegardes (lien avec savegame/)

8. Conseils Pratiques¶

Sauvegardes : synchronisez savegame/ avec un cloud ou un autre disque (rsync, rclone, etc.)
Performances : StarRupture nécessite au minimum 4 Go de RAM réservés — prévoyez une machine adaptée.
Configuration avancée : éditez les fichiers .ini dans server/StarRupture/Saved/Config/LinuxServer/ pour personnaliser le serveur (nom, mot de passe, options de gameplay).
Mises à jour : l'image vérifie et applique les mises à jour au démarrage du conteneur.

9. Sécurité¶

N'exposez que les ports 7777 TCP/UDP et 27015 UDP strictement nécessaires.
Utilisez un pare-feu (ufw, iptables) pour contrôler les accès entrants.
Protégez l'accès au serveur via un mot de passe défini dans les fichiers de configuration.
Sauvegardez régulièrement le dossier savegame/ pour éviter toute perte de progression.

Conclusion¶

Grâce à Docker, l'installation et la gestion d'un serveur StarRupture sont simples et rapides. Vous pouvez maintenant partir à la conquête de l'espace avec vos amis ! 🚀🌌