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 cinq façons de démarrer. Les quatre premières sont classées de la plus simple à la plus technique : la première tient en un clic, la quatrième donne le code source complet pour celles et ceux qui veulent participer à NextBlock. La cinquième confie tout le travail à l'agent de code IA que vous utilisez déjà. 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. Vous travaillez déjà avec un agent de code IA ? Passez directement à l'option 5.

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 sur un écran d'accueil qui propose l'essai gratuit de 30 jours de Cortex AI. Choisissez Not now, take me to my CMS pour aller directement au tableau de bord.

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 22.12 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 ensuite sur le même écran d'accueil et son offre d'essai de Cortex AI.

# 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

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

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 que vous contrôlez (plus un bucket Cloudflare R2 facultatif pour les médias), et elle se déploie partout où Next.js tourne.

Avant de commencer, installez Node.js 22.12 ou plus récent et créez un projet gratuit sur supabase.com. Un bucket Cloudflare R2 pour vos images et fichiers est facultatif mais recommandé, car son offre gratuite est plus généreuse. Sans lui, les médias sont stockés dans le Supabase Storage de votre projet.

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

Au premier prompt, choisissez Managed Cloud Mode (Vercel + Supabase Cloud) ; le projet prend le nom du dossier indiqué (mon-site). 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. Stockage des médias (facultatif) — pour utiliser 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. Laissez les champs vides pour garder les médias dans le Supabase Storage de votre projet.
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. Aucun redémarrage n'est nécessaire, sauf si vous servez les médias depuis un domaine personnalisé.

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
npm run dev

npm run dev démarre le CMS via Nx (il lance npx nx serve nextblock pour vous). 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

Option 5 : Confiez l'installation à votre agent de code IA

Étape 5 · Sans effortIdéal si vous travaillez déjà avec Claude Code, Cursor ou Codex. Nécessite Node.js et Docker Desktop.

Vous pouvez sauter toutes les étapes ci-dessus et simplement demander. Un agent de code qui exécute des commandes sur votre ordinateur peut installer NextBlock, se connecter au CMS et construire vos pages à partir d'une simple description. Essayez : « Crée-moi une page d'accueil pour ma boulangerie avec NextBlock. » En coulisses, l'agent lance l'installateur en mode sans intervention :

npx create-nextblock@latest mon-site --non-interactive

1. L'agent installe le site. L'installateur crée le projet, démarre la pile Docker locale et écrit les fichiers de connexion MCP dont l'agent a besoin.
2. Vous faites deux choses dans le navigateur. Ouvrez le lien de configuration que l'agent vous donne (en général http://localhost:3000/setup) et créez votre compte administrateur. Démarrez ensuite l'essai gratuit de 30 jours de Cortex AI sur l'écran d'accueil, sans carte de crédit. Votre nom, votre email et votre mot de passe ne passent jamais par l'agent.
3. L'agent construit vos pages. Quand le site se déclare prêt, rouvrez l'agent dans le dossier du nouveau projet pour qu'il charge cette connexion. Il crée alors pages, menus et images via le serveur MCP de NextBlock, et vous continuez à tout modifier dans le CMS.

Il vous faut Node.js 22.12+, un agent de code et Docker Desktop en marche. Pas de Docker ? Demandez l'option --mode cloud. L'agent crée le projet et le démarre avec npm run dev, puis vous connectez votre propre projet Supabase dans l'assistant, comme à l'option 3. Le serveur MCP fait partie de Cortex AI, d'où l'essai en premier. Le CMS lui-même reste gratuit dans tous les cas.

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

Chaque chemin vous connecte en tant que premier administrateur et ouvre un écran d'accueil qui propose l'essai gratuit de 30 jours de Cortex AI (sans carte de crédit). Démarrez-le, ou choisissez Not now, take me to my CMS pour aller sur /cms/dashboard. Une checklist de démarrage intégrée vous guide pour la suite :

• Construisez votre site avec Cortex AI — répondez à quelques questions, et Cortex remplace le contenu d'exemple par vos propres pages, menus et identité visuelle (essai gratuit de 30 jours, sans carte de crédit).
• 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 un déploiement Vercel en un clic ou un fork GitHub) les mises à jour automatiques.

Ensuite, découvrez comment la plateforme s'articule dans Comment NextBlock fonctionne, ajoutez une boutique avec le guide Commerce, ou mettez Cortex AI au travail avec le guide Cortex AI et le guide de connexion MCP.

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 22.12+ et Docker Desktop. Pour le mode cloud géré : Node.js 22.12+ ainsi qu'un projet Supabase (un bucket Cloudflare R2 est facultatif). Pour le dépôt cloné : Node.js 22.12+ et git (ajoutez Docker Desktop si vous voulez faire tourner la pile locale). Pour votre agent de code : Node.js 22.12+ et Docker Desktop, ou un projet Supabase avec --mode cloud.

NextBlock est-il gratuit ?

Oui — le cœur du CMS est 100 % gratuit et open source (AGPL). Les packages premium, Commerce Pro et Cortex AI, sont optionnels : chacun démarre par un essai gratuit de 30 jours (sans carte de crédit), puis s'active 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.

Un agent IA peut-il installer et construire mon site ?

Oui. Claude Code, Cursor, Codex et d'autres agents de code peuvent lancer l'installateur pour vous, puis construire chaque page via le serveur MCP. Il vous reste seulement à créer votre compte administrateur et à démarrer l'essai de Cortex AI. Voir l'option 5.

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). Partout ailleurs, une seule commande met à jour le code, les dépendances et le schéma de base de données : npm run update. Avec Docker, enchaînez avec npm run docker:up. Le guide des mises à jour détaille chaque cas de figure.