wiki/Catalogue-Self-Hosted/apps/app-lodestone.md

---
title: Lodestone
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, gaming, minecraft, server-management, multijoueur, rust, react]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Gaming, https://github.com/Lodestone-Team/lodestone]
---

# 🧭 Lodestone

> **Hébergement de serveurs Minecraft (et autres jeux) en self-hosted** — installation one-click, gestion de fichiers, playit.gg intégré, et UI moderne.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | [lodestone.cc](https://www.lodestone.cc/) |
| **GitHub** | [Lodestone-Team/lodestone](https://github.com/Lodestone-Team/lodestone) |
| **License** | AGPL-3.0 |
| **Langage** | Rust (core) + TypeScript/React (dashboard) |
| **Étoiles** | ⭐53 (catalogue) / 1,3k (GitHub) |
| **Dernière MAJ** | 2024-09 (v0.5.1) |
| **Catégorie** | [[cat-gaming\|Gaming]] |

> ⚠️ **Note du catalogue** : la tâche d'origine mentionnait "Java/Spring", ce qui est incorrect. Lodestone est en réalité écrit en **Rust** (backend/core) et **TypeScript/React** (dashboard frontend). Le repo est mature et AGPL-3.0.

## 📝 Description

**Lodestone** est un outil d'hébergement de serveurs de jeux **auto-hébergé**, conçu principalement pour **Minecraft** (Java et Bedrock), mais extensible à d'autres jeux multiplayer. Le projet se positionne comme une alternative self-hosted à **Aternos**, **Minehut**, ou aux coûteux **hosts Minecraft payants** — vous gardez le contrôle total sur votre serveur, vos mods, et vos données.

L'architecture est **Rust + React/TypeScript** : un binaire Rust léger (`lodestone_core`) gère l'installation, l'exécution, le monitoring, et le file management des serveurs ; un dashboard web (React/TypeScript) offre une UI moderne. Lodestone supporte **macros** (scripts d'extension), **playit.gg** (tunneling sans port forwarding), et bientôt la **gestion de conteneurs Docker** pour les serveurs.

L'installation est volontairement **one-click** : vous choisissez une version Minecraft (vanilla, Forge, Fabric, Paper, Spigot, ...), Lodestone télécharge les fichiers, configure les ports, démarre le serveur, et l'expose dans le dashboard. Le **file manager intégré** (ajout récent) permet d'uploader, télécharger, dézipper, copier-coller des mods et configs sans SSH.

**Fonctionnalités clés** :
- ✅ **One-click install** : Vanilla, Forge, Fabric, Paper, Spigot, Bedrock
- ✅ **File manager web** (unzip, upload, download, copy/paste)
- ✅ **Monitoring temps réel** : CPU, RAM, joueurs connectés, TPS
- ✅ **Multi-serveurs** : héberger N serveurs depuis une seule instance
- ✅ **Permissions utilisateurs** (RBAC) : admin, modérateur, joueur
- ✅ **Macros** : scripts d'automatisation (JavaScript/Rust)
- ✅ **playit.gg intégré** : expose le serveur sans port forwarding (utile pour NAT)
- ✅ **Logs centralisés** et historique
- ✅ **Backup** (via macros personnalisées)
- ✅ **Multi-plateforme** : Windows (Desktop), Linux, macOS (Apple Silicon)

## 🚀 Installation

### Option 1 : Binaire Lodestone CLI (Linux/macOS)

```bash
# Télécharger la dernière release
curl -L https://github.com/Lodestone-Team/lodestone/releases/latest/download/lodestone_cli-linux-x86_64 \
  -o /usr/local/bin/lodestone_cli
chmod +x /usr/local/bin/lodestone_cli

# Installer le core
lodestone_cli install

# Démarrer le core
lodestone_cli start
# Le dashboard écoute sur http://localhost:8080
```

### Option 2 : Docker (expérimental — vérifiez la doc actuelle)

```yaml
# docker-compose.yml
services:
  lodestone:
    container_name: lodestone
    image: ghcr.io/lodestone-team/lodestone:latest
    restart: unless-stopped
    ports:
      - "8080:8080"   # dashboard web
      - "25565:25565" # Minecraft par défaut (modifiable)
    volumes:
      - ./lodestone/data:/data         # config, DB, state
      - ./lodestone/servers:/servers   # serveurs Minecraft installés
    environment:
      - TZ=Europe/Paris
      - LODESTONE_SECRET=*** Change...t
```

```bash
docker compose up -d
```

### Option 3 : Lodestone Desktop (Windows)

Télécharger `.exe` sur la page [releases](https://github.com/Lodestone-Team/lodestone/releases). Inclut le core + un dashboard intégré. **Stabilité : "not stable yet"** — préférer la CLI même sur Windows.

### Option 4 : Dashboard hébergé (non self-hosted)

Lodestone propose un dashboard hébergé gratuit sur [lodestone.cc](https://www.lodestone.cc/) utilisable avec votre core local. **Nécessite d'activer le mixed content** dans le navigateur et de désactiver HTTPS Everywhere — c'est leur compromis pour éviter la complexité du TLS local. **Self-host complet recommandé** sinon.

## ⚙️ Configuration

1. **Premier compte admin** : créé au premier accès au dashboard (`http://IP:8080`).
2. **Créer un serveur** : *Servers > New > Minecraft* → choisir la version (ex. 1.21.4), le loader (Vanilla/Forge/Fabric/Paper), l'allocation RAM (ex. 4 Go). Lodestone télécharge et démarre.
3. **playit.gg (optionnel)** : pour exposer le serveur à Internet sans configurer de NAT/port-forwarding : *Settings > Integrations > playit.gg* > s'authentifier → une URL publique est générée.
4. **File manager** : onglet "Files" du serveur → drag-and-drop vos mods `.jar` dans `mods/`, configs dans `config/`.
5. **Permissions** : *Users* pour ajouter des co-admins avec des rôles RBAC.
6. **Macros** : onglet "Macros" pour écrire des scripts d'automatisation (ex. backup quotidien, redémarrage à 4h du matin).
7. **Docker instances (WIP)** : future feature, voir [wiki](https://github.com/Lodestone-Team/lodestone/wiki/Docker-Instance).

## 🔄 Alternatives

### Open Source

- **Pterodactyl Panel** — Panel d'hébergement de serveurs de jeu (Minecraft, CS:GO, etc.), PHP, mature, self-hosté
- **AMP (CubeCoders)** — Panel Minecraft/Java/Valheim, gratuit pour usage perso
- **YAMS (Yet Another Minecraft Server)** — Script bash de gestion simple
- **Docker-Minecraft-Server** — Images Docker officielles par itzg
- **Crafty Controller** — Panel Minecraft + autres, Electron-based
- **McMyAdmin** — Anciennement populaire, peu maintenu
- **MineOS** — Distro Linux dédiée à l'hébergement Minecraft

### Propriétaires (ce que Lodestone remplace)

- **Aternos** — Gratuit, mais avec files d'attente et limitations
- **Minehut** — Freemium, désormais limité
- **Apex Hosting, BisectHosting, Shockbyte** — Hébergeurs payants ($5-30/mois)
- **Realms (Mojang)** — Officiel mais très limité (10 joueurs, pas de mods)
- **PloudOS** — Gratuit, queues importantes

### Tableau comparatif

| Critère | Lodestone | Pterodactyl | Crafty | Aternos |
| :--- | :--- | :--- | :--- | :--- |
| Prix | Gratuit | Gratuit | Gratuit | Freemium |
| Self-hosted | ✅ | ✅ | ✅ | ❌ |
| Support Minecraft | ✅ | ✅ | ✅ | ✅ |
| Multi-jeux | Partiel | ✅ | Partiel | ❌ |
| playit.gg intégré | ✅ | ❌ | ❌ | n/a |
| File manager web | ✅ | ✅ (limité) | ✅ | ❌ |
| Licence | AGPL-3.0 | MIT | GPL-3.0 | Propriétaire |

## 🔐 Sécurité

- **`LODESTONE_SECRET`** : 32+ caractères hex (`openssl rand -hex 32`).
- **Compte admin** : changer le mot de passe par défaut, idéalement 2FA (non natif — utiliser [[app-authelia]] devant le dashboard).
- **Exposer au public** : via playit.gg ou en ouvrant le port 25565 dans votre routeur. Le dashboard (8080) doit **rester sur LAN** ou VPN ([[app-tailscale]]).
- **Whitelist Minecraft** : toujours activer `white-list=true` dans `server.properties` et utiliser `whitelist on` pour restreindre aux joueurs autorisés.
- **Permissions RBAC** : si plusieurs personnes accèdent au dashboard, créer des rôles avec le minimum de privilèges.
- **Backups** : configurer une macro quotidienne (vers `./backups/` ou un montage NFS distant).
- **No formal security audit** : mentionné par l'équipe, à considérer pour les serveurs de production.

## 📚 Ressources

- [Site officiel](https://www.lodestone.cc/)
- [GitHub Lodestone-Team/lodestone](https://github.com/Lodestone-Team/lodestone)
- [Wiki Getting Started](https://github.com/Lodestone-Team/lodestone/wiki/Getting-Started)
- [Wiki How Tos](https://github.com/Lodestone-Team/lodestone/wiki/How-Tos)
- [FAQ sécurité](https://github.com/Lodestone-Team/lodestone/wiki/FAQ)

## Pages Liées

- [[cat-gaming]] — Catégorie Gaming
- [[app-traefik]] — Reverse proxy
- [[app-authelia]] — 2FA devant le dashboard
- [[app-tailscale]] — Accès distant sécurisé
- [[recettes-docker-compose]] — Templates Docker
- [[securisation-home-lab]] — Durcir l'infra