ludix0/runescape repository overview

⁠RuneScape: Dragonwilds — Dedicated Server (Docker)

🇬🇧 English⁠ | 🇫🇷 Français⁠

---

⁠English

Docker container to host a RuneScape: Dragonwilds dedicated server (SteamCMD App ID 4019830). The server auto-updates via SteamCMD (anonymous login, no Steam account needed) and keeps your saves in a separate volume from the rest of the server files.

• Docker Hub image: ludix0/dragonwilds⁠
• Ports used: 7777/udp (game), 27015/udp (Steam query)

⁠Requirements

• Docker (and Docker Compose)
• Your Dragonwilds Player ID: visible in-game under Settings, bottom of the page. The server refuses to start without it (OWNER_ID).

⁠Method 1 — Quick install from Docker Hub (recommended)

Uses the pre-built image directly, no source code needed.

1. Create a folder for your server:

   mkdir -p ~/dragonwilds && cd ~/dragonwilds
   

   Copy

2. Create a docker-compose.yml file with the following content:

   services:
     dragonwilds:
       image: ludix0/dragonwilds:latest
       container_name: dragonwilds
       restart: unless-stopped
       volumes:
         - ./data/filesServer:/home/steam/dragonwilds_server
         - ./data/saves:/home/steam/dragonwilds_saves
         - ./data/steamcmd:/home/steam/steamcmd
       environment:
         - PUID=1000
         - PGID=1000
         - UPDATE_ON_START=true
         - SERVER_NAME=MyServer
         - SERVER_PASSWORD=
         - ADMIN_PASSWORD=
         - OWNER_ID=YOUR_PLAYER_ID_HERE
         - WORLD_NAME=MyWorld
         - SAVE_DIR=/home/steam/dragonwilds_saves
       ports:
         - "7777:7777/udp"
         - "27015:27015/udp"
   

   Copy

3. Replace OWNER_ID with your Player ID, and adjust PUID/PGID if needed (get them with id -u and id -g on your host, so files created in the volumes belong to you).

4. Start the server:

   docker compose up -d
   

   Copy

5. Follow the logs to watch the initial download progress (can take several minutes on first start):

   docker compose logs -f
   

   Copy

To update later, just restart the container (docker compose restart) with UPDATE_ON_START=true: the update runs automatically on startup.

⁠Method 2 — Build from source (GitHub)

Rebuilds the image yourself from the Dockerfile, useful if you want to customize the container's behavior.

1. Clone the repository:

   git clone <YOUR-GITHUB-REPO-URL>
   cd runescape
   

   Copy

2. Create a .env file from the provided example (.env.back) and set at least OWNER_ID:

   cp .env.back .env
   

   Copy

   Then edit .env to set:

   • OWNER_ID (required — your Dragonwilds Player ID)
   • PUID / PGID (via id -u / id -g)
   • SERVER_PASSWORD, ADMIN_PASSWORD (optional)
   • HOST_GAME_PORT, HOST_QUERY_PORT if you host multiple game servers on the same machine and need to avoid port conflicts

3. Build and start the container:

   docker compose build
   docker compose up -d
   

   Copy

⁠Environment variables

⁠Volumes

⁠Ports

---

⁠Français

Conteneur Docker pour héberger un serveur dédié RuneScape: Dragonwilds (SteamCMD App ID 4019830). Le serveur se met à jour automatiquement via SteamCMD (connexion anonyme, aucun compte Steam nécessaire) et conserve vos sauvegardes dans un volume indépendant du reste des fichiers du serveur.

• Image Docker Hub : ludix0/dragonwilds⁠
• Ports utilisés : 7777/udp (jeu), 27015/udp (requête Steam)

⁠Prérequis

• Docker (et Docker Compose)
• Votre Player ID Dragonwilds : visible en jeu dans Paramètres, en bas de la page. Le serveur refuse de démarrer sans cette valeur (OWNER_ID).

⁠Méthode 1 — Installation rapide depuis Docker Hub (recommandée)

Cette méthode utilise directement l'image déjà construite, sans avoir besoin du code source.

1. Créez un dossier pour votre serveur :

   mkdir -p ~/dragonwilds && cd ~/dragonwilds
   

   Copy

2. Créez un fichier docker-compose.yml avec le contenu suivant :

   services:
     dragonwilds:
       image: ludix0/dragonwilds:latest
       container_name: dragonwilds
       restart: unless-stopped
       volumes:
         - ./data/filesServer:/home/steam/dragonwilds_server
         - ./data/saves:/home/steam/dragonwilds_saves
         - ./data/steamcmd:/home/steam/steamcmd
       environment:
         - PUID=1000
         - PGID=1000
         - UPDATE_ON_START=true
         - SERVER_NAME=MonServeur_FR
         - SERVER_PASSWORD=
         - ADMIN_PASSWORD=
         - OWNER_ID=VOTRE_PLAYER_ID_ICI
         - WORLD_NAME=MonMonde
         - SAVE_DIR=/home/steam/dragonwilds_saves
       ports:
         - "7777:7777/udp"
         - "27015:27015/udp"
   

   Copy

3. Remplacez OWNER_ID par votre Player ID, et ajustez PUID/PGID si besoin (récupérables avec les commandes id -u et id -g sur votre machine hôte, pour que les fichiers créés dans les volumes vous appartiennent).

4. Démarrez le serveur :

   docker compose up -d
   

   Copy

5. Suivez les logs pour voir la progression du téléchargement du serveur (peut prendre plusieurs minutes au premier démarrage) :

   docker compose logs -f
   

   Copy

Pour mettre à jour le serveur plus tard, il suffit de relancer le conteneur (docker compose restart) avec UPDATE_ON_START=true : la mise à jour se fait automatiquement au démarrage.

⁠Méthode 2 — Construction depuis les sources (GitHub)

Cette méthode reconstruit l'image vous-même à partir du Dockerfile, utile si vous voulez modifier le comportement du conteneur.

1. Clonez le dépôt :

   git clone <URL-DE-VOTRE-DEPOT-GITHUB>
   cd runescape
   

   Copy

2. Créez un fichier .env à partir de l'exemple fourni (.env.back) et renseignez au minimum OWNER_ID :

   cp .env.back .env
   

   Copy

   Puis éditez .env pour définir :

   • OWNER_ID (obligatoire — votre Player ID Dragonwilds)
   • PUID / PGID (via id -u / id -g)
   • SERVER_PASSWORD, ADMIN_PASSWORD (optionnels)
   • HOST_GAME_PORT, HOST_QUERY_PORT si vous hébergez plusieurs serveurs de jeu sur la même machine et devez éviter les conflits de ports

3. Construisez et démarrez le conteneur :

   docker compose build
   docker compose up -d
   

   Copy

⁠Variables d'environnement

⁠Volumes

⁠Ports