Installation

Auto-hébergez OpenTraderWorld sur votre machine ou votre serveur. Compter environ 5 minutes.

Conteneurs uniquement (pour l'instant)

OpenTraderWorld tourne comme une pile Docker Compose, le seul déploiement pris en charge. Une installation native est possible mais déconseillée : Docker garde l'installation non intrusive (tout vit dans des conteneurs et des volumes) et rapide à reconstruire. Voir Installer Docker pour les raisons et les étapes par système.

Prérequis

• Docker avec Docker Compose. Vous ne l'avez pas ? Installer Docker couvre macOS, Windows et Linux en quelques commandes.
• Linux, macOS ou Windows.
• Un port libre (5454 par défaut ; les ports 80 + 443 pour les modes HTTPS). Vous pouvez le changer pendant la configuration.

Vérifiez que Docker est prêt :

docker --version
docker compose version

Installation en une commande (recommandée)

curl -fsSL https://raw.githubusercontent.com/G-OTW/OpenTraderWorld/master/install.sh | bash

L'installateur vérifie que Docker est prêt, télécharge les fichiers de déploiement (uniquement le dossier deploy/, sans code source ni chaîne d'outils) dans ./opentraderworld, puis passe la main à la configuration guidée ci-dessous, qui récupère les images préconstruites depuis Docker Hub.

Les options se placent après bash -s -- :

curl -fsSL https://raw.githubusercontent.com/G-OTW/OpenTraderWorld/master/install.sh | bash -s -- --dir ~/otw

Option	Par défaut	Notes
--dir <path>	./opentraderworld	Dossier d'installation. Refuse un dossier non vide ou une installation existante.
--ref <ref>	master	Branche ou tag à installer.
--build	désactivé	Clone tout le code source et construit les images localement au lieu de les récupérer (nécessite git et la chaîne d'outils).

Depuis un clone git (alternative)

git clone https://github.com/G-OTW/OpenTraderWorld.git
cd OpenTraderWorld/deploy
./setup.sh

La configuration guidée

Les deux voies ci-dessus exécutent deploy/setup.sh. Il pose quelques questions, génère des secrets robustes, écrit la configuration et démarre tout.

Il demande :

Question	Par défaut	Notes
Mode réseau	1 (localhost)	1 cette machine uniquement · 2 réseau local en HTTP simple · 3 réseau local en HTTPS avec un vrai certificat · 4 Internet public sur votre propre domaine. Modifiable ensuite, voir Réseau et accès à distance.
Nom d'utilisateur admin	admin	Le compte admin est créé pour vous ; un mot de passe robuste est généré et affiché une seule fois.
Port HTTP	5454	Modes 1 et 2 uniquement ; les modes 3 et 4 utilisent 80 + 443.
Domaine DuckDNS / token / IP du réseau local	aucun	Mode 3 uniquement.
Domaine public	aucun	Mode 4 uniquement, et il doit déjà pointer vers ce serveur.
Niveau de log	info	trace / debug / info / warn / error.

Les secrets de base de données et de session sont générés automatiquement, vous ne les saisissez donc jamais. Ils sont écrits dans deploy/.env (permissions de fichier 600, jamais commité dans git).

À la fin, laissez le script démarrer la pile : il attend l'API, crée votre compte admin et affiche le mot de passe généré une seule fois, copiez-le donc avant de fermer le terminal.

Par défaut, la configuration récupère les images préconstruites depuis Docker Hub : pas de chaîne d'outils Rust ou Node, premier démarrage en quelques minutes. Lancez ./setup.sh --build pour construire les trois services depuis les sources (développement, modifications locales).

Serveurs sans écran

L'admin est créé par le core lui-même au premier démarrage (depuis deploy/.env), vous n'avez donc pas besoin de navigateur sur le serveur. Notez le mot de passe affiché et connectez-vous depuis n'importe quelle machine qui peut joindre l'application.

Réinstaller par-dessus d'anciennes données

Si des volumes Docker d'une installation précédente existent, la configuration propose de les effacer. La réponse par défaut est Non partout : l'effacement (et la perte de l'ancienne base) n'a lieu que sur un y explicite. De nouveaux secrets sur un ancien volume de base ne peuvent pas fonctionner, donc refuser interrompt la configuration plutôt que de démarrer une pile cassée.

Installation manuelle (alternative)

Si vous préférez configurer à la main :

cd deploy
cp .env.example .env

Modifiez .env et définissez au moins :

• POSTGRES_PASSWORD : un mot de passe robuste
• DATABASE_URL : doit contenir le même mot de passe, p. ex. postgres://otw:YOUR_PASSWORD@postgres:5432/opentraderworld
• SESSION_SECRET : une longue chaîne aléatoire

Puis démarrez la pile. Par défaut, cela récupère les images préconstruites depuis Docker Hub (aucune chaîne d'outils Rust ou Node requise) :

docker compose -f docker-compose.yml -f docker-compose.images.yml \
  --env-file .env --env-file network.env up -d

Construire depuis les sources à la place

Pour le développement, ou pour exécuter des modifications locales, omettez la surcharge d'images et construisez vous-même les trois services (nécessite la chaîne d'outils ; la compilation Rust est lente) :

docker compose --env-file .env --env-file network.env up --build -d

Créer l'admin (installations manuelles uniquement)

Si vous avez utilisé ./setup.sh et l'avez laissé démarrer la pile, votre admin existe déjà, passez donc à la suite.

Sinon, ouvrez l'application dans votre navigateur (http://localhost:5454 par défaut). À la première visite, OpenTraderWorld détecte qu'il n'y a pas encore d'admin et affiche l'assistant de configuration : choisissez un nom d'utilisateur et un mot de passe (8 caractères minimum), validez, et vous arrivez sur le dashboard. Les mots de passe sont stockés hachés avec argon2.

Créer l'admin en ligne de commande (sans écran, sans navigateur)

Appelez le point d'entrée de premier lancement depuis l'intérieur de la pile : cela fonctionne quelle que soit votre interface de liaison ou votre mode TLS, et refuse (HTTP 409) si un admin existe déjà :

cd deploy
docker compose --env-file .env --env-file network.env exec -T caddy \
  wget -qO- --header=Content-Type:application/json \
  --post-data='{"username":"admin","password":"CHOOSE-A-STRONG-ONE"}' \
  http://core:8080/api/setup

Vérifier que ça tourne

• Application : http://localhost:5454 (ou le port/domaine choisi)
• Contrôle de santé : http://localhost:5454/api/health → {"status":"ok","service":"otw-core",...}

cd deploy
docker compose ps            # container status
docker compose logs -f core  # follow core logs

Opérations courantes

Exécutez-les depuis deploy/ :

Action	Commande
Démarrer	docker compose up -d
Arrêter	docker compose down
Voir les logs	docker compose logs -f
Récupérer des images plus récentes	docker compose -f docker-compose.yml -f docker-compose.images.yml pull && docker compose up -d
Reconstruire après un changement de code (build depuis les sources)	docker compose up --build -d
Arrêter et effacer toutes les données	docker compose down -v

Vos données vivent dans des volumes nommés Docker et persistent entre les up/down. Elles ne sont supprimées qu'avec down -v.

Étapes suivantes

• Premiers pas : connexion, valeurs par défaut, installation des modules.
• Réseau et accès à distance : joindre l'application depuis d'autres appareils, HTTPS sur réseau local, exposition publique.
• Un problème ? Voir Dépannage.