Démarrage rapide

Prérequis

Avant de commencer, assurez-vous d’avoir installé :

Docker 24+ et Docker Compose v2
Git
Un terminal (bash, zsh ou PowerShell)

Aucun environnement PHP, Node.js ou base de données à installer localement — tout tourne dans les conteneurs.

Étape 1 — Cloner le dépôt

git clone https://github.com/fatplant/fatplant.git
cd fatplant

Étape 2 — Configurer l’environnement

Copiez le fichier d’exemple et adaptez-le si nécessaire :

cp .env.example .env

Pour un premier démarrage local, les valeurs par défaut suffisent. Vous pourrez les ajuster plus tard (voir Configuration).

Étape 3 — Démarrer les services

docker compose up -d

Cette commande télécharge les images et démarre les conteneurs suivants :

Service	Rôle
`backend`	API Symfony + API Platform
`admin`	Interface d’administration SvelteKit
`frontend`	Frontend public SvelteKit SSR
`yjs`	Serveur de collaboration temps réel
`db`	PostgreSQL
`redis`	Cache et sessions

Le premier démarrage peut prendre 1 à 2 minutes le temps de compiler les assets et d’initialiser la base de données.

Étape 4 — Vérifier que tout fonctionne

docker compose ps

Tous les services doivent afficher l’état Up (healthy). Si un service est en starting, attendez quelques secondes et relancez la commande.

Étape 5 — Première connexion

Ouvrez votre navigateur à l’adresse http://localhost:4173 (port par défaut de l’admin).

Les identifiants par défaut sont :

Email : admin@fatplant.local
Mot de passe : fatplant

Attention : changez immédiatement ce mot de passe en production via le menu Paramètres > Profil.

Étape 6 — Créer votre premier article

Dans le menu gauche, cliquez sur Articles.
Cliquez sur le bouton + Nouvel article.
Renseignez le titre, le slug et le contenu.
Sélectionnez une catégorie ou créez-en une.
Cliquez sur Enregistrer (brouillon) ou Publier.

Votre article est immédiatement disponible via l’API publique :

curl http://localhost:8000/api/public/articles

Étape 7 — Accéder au frontend

Le frontend public SSR est disponible à http://localhost:3000. Il affiche automatiquement les articles publiés.

Commandes utiles

# Voir les logs du backend
docker compose logs -f backend

# Relancer un service après modification de .env
docker compose restart backend

# Arrêter tous les services
docker compose down

# Arrêter et supprimer les volumes (reset complet)
docker compose down -v

Et ensuite ?

Consultez la documentation d’installation pour un déploiement en production.
Explorez le modèle de contenu pour comprendre les entités disponibles.
Découvrez le page builder pour créer des pages visuelles.