Comment déployer un projet Bolt.new sur votre propre serveur

Pour déployer un projet Bolt.new sur votre propre serveur, connectez le projet à GitHub ou téléchargez-le en zip, confiez le code au panneau Coolify de votre serveur, définissez les variables d'environnement et faites pointer votre domaine vers lui. La documentation de Bolt dit la même chose : une fois le code sur GitHub, vous pouvez publier via un autre service de votre choix. Si vous prenez la voie GitHub, vous pouvez continuer à travailler dans Bolt et vos modifications arrivent d'elles-mêmes dans le dépôt.

Bolt est centré sur JavaScript. Sa pile prise en charge est Node.js côté backend et des frameworks pour navigateur côté frontend, sans backend Python ni PHP. Votre projet est donc très probablement un projet Node ordinaire avec un package.json, et il n'a besoin de rien de spécifique à Bolt pour tourner.

Comment sortir le code de Bolt ?

Via GitHub

1. Ouvrez le projet, cliquez sur l'icône GitHub en haut à droite, connectez-vous avec votre compte GitHub et accordez l'accès demandé.
2. Nommez le dépôt et appuyez sur Create repository.
3. Le dépôt démarre en privé sur une branche main. Dès lors, Bolt y envoie chaque modification.

En zip

Cliquez sur le nom du projet en haut à gauche, puis sur Download. Un zip est une copie ponctuelle et ne reprend pas les modifications ultérieures dans Bolt. Le serveur déploie depuis un dépôt Git : vous devriez donc quand même l'y placer. Le décompresser et exécuter npm install && npm run dev est un moyen rapide de voir le code tourner en dehors de Bolt.

De quel type de projet s'agit-il ?

Le projet détermine les réglages : vérifiez donc les dépendances dans package.json. Les lignes Next.js, Vite et Astro sont des réglages que nous avons essayés avec Coolify sur un vrai serveur.

Si un projet Vite gère le routage des pages dans le navigateur, réglez Site type sur SPA dans la page General. L'oublier est la raison habituelle pour laquelle une page imbriquée renvoie une erreur 404 à l'actualisation.

Pas à pas

1. Commandez un serveur depuis la page VPS Next.js. Cette option est livrée avec Coolify : vous déployez donc depuis le même panneau même si votre projet n'est pas Next.js.
2. Clonez le dépôt et exécutez npm run build. Un code qui tourne dans l'aperçu de Bolt peut quand même échouer à une compilation de production, et mieux vaut le découvrir avant le serveur.
3. Ouvrez le dossier dans un outil de code comme Claude Code ou Cursor. Copiez la ligne Collez dans votre outil d'IA de l'onglet Vue d'ensemble de votre panneau Seturack et collez-la. L'outil lit les instructions et déploie, en ajoutant une clé de déploiement en lecture seule pour le dépôt privé.
4. Donnez-lui les variables d'environnement qu'attend votre code, et gardez les valeurs hors du code.
5. Quand l'adresse HTTPS arrive, testez les pages, la connexion et l'écriture de données.
6. Faites pointer un enregistrement A vers l'adresse IP du serveur et indiquez le nom de domaine à l'outil. Le certificat est émis automatiquement.

Vous pouvez aussi tout faire à la main dans Coolify, comme l'explique notre guide Next.js. Vous avez l'accès root, et vous pouvez tout gérer depuis le panneau si vous préférez.

Éviter que chaque modification passe en ligne

Voici un détail propre à Bolt. Comme il envoie chaque modification au dépôt, un webhook sur main signifie que chaque prompt lance une nouvelle compilation, et que des essais inachevés passent en ligne. Pour l'éviter, cliquez sur l'icône GitHub, utilisez Create new branch pour travailler sur une branche séparée et fusionnez dans main quand vous avez fini. Le serveur ne surveille que main : les visiteurs voient donc la version terminée.

Que devient Bolt Database ?

Bolt Database garde vos données, la connexion, le stockage de fichiers et les fonctions serveur dans Bolt Cloud. Déplacer le code laisse tout cela où c'est : vous choisissez donc la suite.

Les clés de la page Secrets de Bolt servent à ses fonctions serveur. Le code qui tourne sur votre serveur les lit dans des variables d'environnement : vous les saisissez donc vous-même à cet endroit.

Questions fréquentes

De quelle puissance de serveur un projet Bolt.new a-t-il besoin ?

La page de vente recommande au moins 4 Go de RAM, 2 vCores et 40 Go de disque. Les compilations Next.js demandent plus de mémoire à mesure que le projet grossit : un projet de 85 paquets a échoué avec 2 Go et s'est compilé avec 4 Go, tandis qu'un petit est passé avec 2 Go. Si cela ne suffit pas, augmentez la taille depuis votre panneau.

Combien cela coûtera-t-il par mois ?

La taille minimale recommandée coûte environ $6 par mois (TVA incluse), et hors de Turquie, vous payez en dollars américains. La sauvegarde quotidienne est incluse dans le prix et le trafic est illimité. Votre abonnement Bolt est à part et continue si vous poursuivez le développement là-bas.

Comment raccorder mon domaine ?

Faites pointer un enregistrement A vers l'adresse IP du serveur, ajoutez le domaine à l'application et déployez à nouveau. Le certificat est émis automatiquement. Notre article d'aide traite de l'enregistrement.

Comment une modification dans Bolt arrive-t-elle sur le serveur ?

Bolt l'envoie à GitHub, et avec un webhook le serveur recompile à chaque push sur la branche surveillée. Sans webhook, appuyez sur Redeploy dans Coolify.

Puis-je déplacer la base de données vers PostgreSQL dans Coolify ?

Si votre code parle directement à la base de données en SQL, oui. Bolt Database couvre aussi la connexion, les fichiers et les fonctions serveur, et un simple PostgreSQL ne les remplacera pas si votre code en dépend. Dans ce cas, la voie Supabase demande moins de changements de code.

Prêt à l'emploi chez Seturack : Next.js, Coolify, Supabase.