Installer Bracten

Préparer l’environnement#

Le dépôt nécessite Node.js 22.12 ou supérieur, pnpm 10.32.1 et PostgreSQL 16 ou supérieur, via Docker Compose ou une installation native. La base du site doit être dédiée et son rôle ne doit être ni superutilisateur, ni autorisé à créer des bases ou des rôles. Pour les sauvegardes natives, pg_dump et pg_restore doivent être compatibles avec la version majeure de PostgreSQL.

git clone https://github.com/lprpdev/bracten.git
cd bracten
pnpm install --frozen-lockfile
pnpm setup:local

setup:local prépare un fichier .env avec des secrets distincts et conserve les identifiants déjà présents. Ce fichier est privé et ignoré par Git. Conservez la clé CMS_BACKUP_KEY séparément des sauvegardes.

Démarrer le CMS#

pnpm db:up
pnpm build
pnpm start

Ouvrez http://localhost:4310/install. Avec PostgreSQL natif dans le PATH, remplacez pnpm db:up par pnpm db:local. Ce deuxième mode utilise une instance dédiée sur 127.0.0.1:55441. Ne lancez pas ces deux modes sur le même port.

Pour lancer l’ensemble dans Docker après setup:local, utilisez la commande suivante. Les volumes conservent la base et les données entre les redémarrages.

docker compose --profile app up -d --build --wait

Le serveur peut aussi démarrer sans DATABASE_URL : il affiche l’assistant avant d’ouvrir la base. L’étape PostgreSQL permet de connecter une base vide existante ou d’en préparer une avec un rôle limité. La connexion retenue est conservée dans un fichier privé du répertoire de données ; les identifiants privilégiés de préparation ne sont pas enregistrés. Une connexion déjà configurée mais indisponible bloque le démarrage et ne déclenche pas une nouvelle installation.

Parcourir les sept étapes#

1. Prérequis : saisissez CMS_INSTALL_TOKEN de votre configuration privée et lancez les contrôles. Ne partagez pas cette clé.
2. PostgreSQL : vérifiez la connexion configurée, connectez une base vide ou préparez une base et son rôle limité. Le serveur vérifie la version et les privilèges avant les migrations.
3. Votre site : renseignez son nom et sa description.
4. Administrateur : saisissez votre nom, votre adresse e-mail et un mot de passe d’au moins 12 caractères, puis confirmez-le.
5. Point de départ : conservez le site vide ou sélectionnez un pack disponible. Examinez son thème, ses extensions, leurs permissions et les contenus prévus.
6. Installation : relisez le récapitulatif puis confirmez. L’assistant crée le compte et applique la sélection.
7. Connexion : ouvrez l’administration et connectez-vous avec le compte que vous venez de créer.

Sans pack, Bracten installe Starter et laisse les contenus vides. Site vitrine et Blog proposent des structures facultatives en brouillon, sans compte fictif ni contenu publié. Les cinq packs métier signés Business, Directory, Catalog, Membership et Developer ajoutent des extensions configurées, sans données de démonstration. Un exploitant doit les importer avant leur sélection ; consultez les packs de démarrage.

L’installation est verrouillée une fois terminée. Un compte existant doit se connecter : recommencer l’installation ne réinitialise pas les accès.

Préparer un serveur distant#

Choisissez d’abord le VPS et créez un staging isolé. Définissez NODE_ENV=production, une origine CMS_ORIGIN en HTTPS, des secrets propres à cet environnement et un stockage persistant. Gardez PostgreSQL privé. Configurez CMS_TRUSTED_PROXIES avec les seules adresses de vos proxies et faites remplacer Host et X-Forwarded-Proto par le proxy. La page Domaines et redirections détaille les contrôles d’origine.

Ne partagez jamais la base, les données ou la clé de sauvegarde entre staging et production. Le fonctionnement local ne valide pas le DNS, TLS ou les cookies du domaine final. Consultez les guides de sauvegarde et de mise à jour avant une livraison.