Installer NextBlock : toutes les options expliquées

NextBlock est un CMS open source et natif IA, construit sur Next.js et Supabase — et son installation ne passe plus par des fichiers de configuration, des assistants en ligne de commande ou du SQL manuel. Voici quatre façons de démarrer, classées de la plus simple à la plus technique : la première tient en un clic, la dernière donne le code source complet pour celles et ceux qui veulent participer à NextBlock. Elles aboutissent toutes au même endroit — un assistant de configuration dans le navigateur qui connecte votre base de données, configure le stockage des médias et crée votre compte administrateur.

Vous ne savez pas par où commencer ? Descendez la liste — choisissez la première option dont vous avez déjà les prérequis. La plupart des gens devraient commencer par Vercel.

Option 1 : Déploiement Vercel en un clic

Étape 1 · Le plus simpleIdéal pour un site en ligne avec le minimum d'effort — pas de terminal, aucun compte à configurer.

Le moyen le plus rapide d'obtenir un site NextBlock en production. Un seul bouton crée votre propre copie de NextBlock sur GitHub, provisionne une base de données Supabase gérée et déploie le site — sans jamais ouvrir un terminal ni copier la moindre clé.

1. Cliquez sur Deploy to Vercel et connectez-vous — Vercel clone NextBlock dans un nouveau dépôt qui vous appartient.
2. Nommez le dépôt — et rendez-le Public. À la première étape sur Vercel, vous choisissez le nom du dépôt ; réglez sa visibilité sur Public plutôt que Privé. Un dépôt public est ce qui débloque les mises à jour automatiques en un clic plus tard — c'est donc le choix recommandé.
3. Créez la base de données Supabase quand on vous le demande : choisissez un nom et une région. Vercel la connecte au projet et injecte les clés avant le premier build.
4. Ouvrez votre nouveau site une fois le build terminé. Toute nouvelle instance vous amène directement à l'assistant de configuration.
5. Créez votre compte administrateur. Il est confirmé instantanément — aucun email de vérification — et vous arrivez dans le tableau de bord du CMS.

Option 2 : npm create nextblock → Docker (100 % local)

Étape 2 · FacileIdéal pour tout essayer sur votre machine sans aucun compte cloud. Nécessite Docker Desktop.

Faites tourner NextBlock entièrement sur votre machine, sans aucun compte cloud. Le CLI génère une application Next.js autonome puis démarre toute la pile dans Docker pour vous : les moteurs Postgres et auth de Supabase, une API PostgREST derrière une passerelle Kong, un stockage MinIO compatible S3 et le CMS lui-même — idéal pour les évaluations, les environnements isolés et la pleine propriété de vos données.

Avant de commencer, installez Node.js 20 ou plus récent (npm inclus) et Docker Desktop, et assurez-vous que Docker Desktop est démarré.

npm create nextblock@latest mon-site

1. Choisissez le profil d'hébergement. Au premier prompt, choisissez Local Self-Hosted Docker Mode (One-Click Local Sandbox), puis confirmez que Docker Desktop est installé et démarré.
2. Laissez faire. Le CLI copie le template, installe les dépendances, génère des clés sécurisées et démarre toute la pile avec une seule commande Docker — sans aucune question. Le premier lancement télécharge les images et construit l'app, comptez donc quelques minutes ; chaque migration de base de données est appliquée automatiquement au démarrage de la pile.
3. Ouvrez http://localhost:3000 — vous êtes redirigé vers l'assistant de configuration. Comme la base de données et le stockage MinIO sont déjà connectés, les étapes de connexion et de stockage sont ignorées : il ne reste qu'à créer votre administrateur (confirmé instantanément, sans email). Vous arrivez dans le tableau de bord du CMS.

# reconstruire et redémarrer la pile
npm run docker:up

# arrêter la pile (vos données persistent dans les volumes Docker)
npm run docker:down

# suivre les logs de l'application
npm run docker:logs

Option 3 : npm create nextblock → votre propre Supabase + Cloudflare

Étape 3 · IntermédiaireIdéal pour construire votre propre site sur du cloud géré. Nécessite un projet Supabase et un bucket R2.

Le meilleur point de départ pour construire votre propre site sur du cloud géré. Le CLI génère une application Next.js autonome avec NextBlock déjà intégré — sans monorepo ni outillage de workspace — reliée à un projet Supabase et un bucket Cloudflare R2 que vous contrôlez, et elle se déploie partout où Next.js tourne.

Avant de commencer, installez Node.js 20 ou plus récent, créez un projet gratuit sur supabase.com, et configurez un bucket Cloudflare R2 pour vos images et fichiers.

npm create nextblock@latest mon-site
cd mon-site
npm run dev

Au premier prompt, choisissez Managed Cloud Mode (Vercel + Supabase Cloud) et nommez votre projet. Ouvrez ensuite http://localhost:3000/setup et laissez l'assistant faire le travail :

1. Connectez Supabase — collez l'URL du projet, la clé publiable (anon), la clé secrète (service role) et un jeton d'accès personnel pour que l'assistant applique le schéma de base de données à votre place.
2. Ajoutez Cloudflare R2 — saisissez votre identifiant de compte R2, le nom du bucket, la clé d'accès (access key ID), la clé secrète et l'URL publique du bucket pour servir vos images et fichiers.
3. Créez votre administrateur — l'assistant applique toutes les migrations, génère les secrets de l'application, écrit .env.local, crée votre compte admin confirmé et vous connecte. Redémarrez ensuite npm run dev une fois pour que le nouvel environnement soit intégré à l'application.

Option 4 : Cloner le dépôt

Étape 4 · AvancéIdéal pour les contributeurs et les équipes qui veulent personnaliser la plateforme. Nécessite Node.js et git.

Faites tourner le monorepo Nx complet : l'application CMS, tous les packages partagés, le code du CLI et la documentation. C'est le chemin de celles et ceux qui veulent participer au projet — contributeurs, auteurs de plugins et équipes qui personnalisent la plateforme elle-même.

git clone https://github.com/nextblock-cms/nextblock.git
cd nextblock
npm install
npx nx serve nextblock

Ouvrez http://localhost:4200 — une nouvelle installation redirige chaque page vers /setup, où le même assistant en trois étapes connecte Supabase, configure le stockage et crée votre admin. Il valide vos clés, écrit .env.local avec des secrets générés, et applique toutes les migrations via l'API de management Supabase — sans CLI Supabase.

npm run docker:setup

Après l'installation : vos 10 premières minutes

Chaque chemin vous dépose sur /cms/dashboard, connecté en tant que premier administrateur. Une checklist de démarrage intégrée vous guide pour la suite :

• Ajoutez votre identité visuelle — téléversez votre logo et définissez le titre du site.
• Réglez votre pied de page — mention de copyright et navigation du pied de page.
• Configurez l'email (SMTP) — dans les réglages, pour que les réinitialisations de mot de passe et les invitations partent bien.
• Extras optionnels — connectez vos outils d'analytics, activez la protection anti-bots et (sur Vercel) les mises à jour automatiques.

Ensuite, découvrez comment la plateforme s'articule dans Comment NextBlock fonctionne, ou ajoutez une boutique avec le guide Commerce.

FAQ d'installation

Que dois-je installer ?

Rien pour le chemin Vercel — tout se passe dans le navigateur. Pour npm create nextblock en mode Docker : Node.js 20+ et Docker Desktop. Pour le mode cloud géré : Node.js 20+ ainsi qu'un projet Supabase et un bucket Cloudflare R2. Pour le dépôt cloné : Node.js 20+ et git (ajoutez Docker Desktop si vous voulez faire tourner la pile locale).

NextBlock est-il gratuit ?

Oui — le cœur du CMS est 100 % gratuit et open source (AGPL). Les packages premium comme l'e-commerce et Cortex AI sont optionnels et s'activent avec une clé de licence. Vercel et Supabase proposent chacun une offre gratuite : un site de départ peut donc tourner sans frais.

Ai-je besoin d'un compte Supabase ?

Sur Vercel, la base de données est créée pour vous pendant le déploiement. Pour le chemin cloud géré npm create nextblock et le dépôt cloné, il vous faut un projet Supabase gratuit. Avec Docker — via le mode Docker du CLI ou npm run docker:setup dans le clone — aucun compte cloud n'est nécessaire.

Dois-je exécuter des migrations ou du SQL à la main ?

Non. L'assistant de configuration, le build Vercel et la pile Docker appliquent tous le schéma de base de données automatiquement — et relancer l'opération est toujours sans risque.

Puis-je changer de chemin plus tard ?

Oui. Chaque chemin exécute la même application et le même schéma de base de données : vous pouvez prototyper en local avec Docker aujourd'hui et déployer sur Vercel demain. NextBlock se déploie comme n'importe quelle app Next.js.

Comment mettre à jour NextBlock ?

Sur Vercel, l'étape Connect GitHub de la checklist active une synchronisation quotidienne automatique (cela nécessite un dépôt public). Sur un dépôt cloné, git pull, lancez npm run db:migrate, puis redémarrez (lors des builds de production, les migrations en attente s'appliquent automatiquement). Avec Docker, récupérez le dernier code et lancez npm run docker:up.