Skip to main content
Ce guide vous amène d’un dépôt vide à une instance Komamy fonctionnelle. Deux chemins possibles : Docker (recommandé, décrit ici) ou une installation manuelle avec Bun + PostgreSQL (voir Déploiement pour le détail complet, les variables d’environnement et le déploiement sans Docker).

Prérequis

  • Docker et Docker Compose
  • Le dépôt Komamy cloné localement
1

Créer les volumes persistants

Les volumes sont déclarés external: true dans docker-compose.yml — ils doivent exister avant le premier démarrage :
Cette précaution évite qu’une plateforme de déploiement (Dokploy, Coolify, CapRover…) ne recrée le volume — et donc n’efface vos images — à chaque redéploiement. Voir Déploiement pour le détail.
2

Configurer l'environnement

Éditez au minimum .env :
  • JWT_SECRET — obligatoire en production (openssl rand -base64 48)
  • ADMIN_USERNAME / ADMIN_PASSWORD — identifiants du compte admin créé au premier démarrage
  • POSTGRES_PASSWORD — mot de passe de la base Postgres du conteneur
3

Démarrer la stack

Deux conteneurs démarrent : postgres (PostgreSQL 16) et komamy (l’application). Au premier lancement, les migrations sont appliquées et le compte administrateur est créé automatiquement — aucune étape manuelle supplémentaire.
4

Se connecter

Ouvrez http://localhost:3000 (port configurable via PORT) et connectez-vous avec les identifiants admin définis à l’étape 2 (ou les valeurs par défaut admin / changeme123 si vous ne les avez pas changées).
Changez immédiatement le mot de passe admin par défaut depuis /settings une fois connecté.

Et maintenant ?

Publier votre premier projet

Créez une fiche de projet webcomic et ajoutez-y un chapitre.

Comprendre les rôles

admin, modérateur, lecteur — et la règle d’appartenance à une équipe.

Variables d'environnement complètes

Toutes les options de déploiement, avec ou sans Docker.

Développer sur Komamy

Lancer le serveur de développement (bun run dev), architecture du code.
Besoin d’aide ? Consultez la documentation développeur ou ouvrez une issue sur le dépôt GitHub.