Cómo publicar un proyecto de Bolt.new en tu propio servidor

Para publicar un proyecto de Bolt.new en tu propio servidor, conecta el proyecto a GitHub o descárgalo como zip, entrega el código al panel Coolify de tu servidor, configura las variables de entorno y apunta tu dominio. La documentación de Bolt dice lo mismo: una vez que el código está en GitHub, puedes publicar con otro servicio de tu elección. Si eliges la vía de GitHub, puedes seguir trabajando en Bolt y tus cambios llegan solos al repositorio.

Bolt se centra en JavaScript. Su stack admitido es Node.js en el backend y frameworks de navegador en el frontend, sin backends de Python ni PHP. Así que tu proyecto es, con toda probabilidad, un proyecto Node corriente con un package.json, y no necesita nada específico de Bolt para funcionar.

¿Cómo sacas el código de Bolt?

A través de GitHub

1. Abre el proyecto, haz clic en el icono de GitHub de arriba a la derecha, inicia sesión con tu cuenta de GitHub y concede el acceso que te pide.
2. Pon nombre al repositorio y pulsa Create repository.
3. El repositorio empieza como privado en una rama main. A partir de ahí, Bolt le envía cada cambio.

Como zip

Haz clic en el nombre del proyecto de arriba a la izquierda y luego en Download. Un zip es una copia única y no recoge los cambios posteriores en Bolt. El servidor publica desde un repositorio Git, así que aun así tendrías que ponerlo en uno. Descomprimirlo y ejecutar npm install && npm run dev es una forma rápida de ver el código funcionar fuera de Bolt.

¿Qué tipo de proyecto es?

El proyecto decide los ajustes, así que revisa las dependencias en package.json. Las filas de Next.js, Vite y Astro son ajustes que hemos probado con Coolify en un servidor real.

Si un proyecto de Vite enruta las páginas en el navegador, establece Site type en SPA en la página General. Olvidarlo es el motivo habitual de que una página anidada devuelva un 404 al refrescar.

Paso a paso

1. Pide un servidor en la página de VPS para Next.js. Esta opción incluye Coolify, así que publicas desde el mismo panel aunque tu proyecto no sea Next.js.
2. Clona el repositorio y ejecuta npm run build. El código que funciona en la vista previa de Bolt aún puede fallar en una compilación de producción, y es mejor enterarse antes de que lo haga el servidor.
3. Abre la carpeta en una herramienta de programación como Claude Code o Cursor. Copia la fila Pégalo en tu herramienta de IA de la pestaña Resumen de tu panel de Seturack y pégala. La herramienta lee las instrucciones y publica, y añade una deploy key de solo lectura para el repositorio privado.
4. Dale las variables de entorno que espera tu código y mantén los valores fuera del código.
5. Cuando llegue la dirección HTTPS, prueba las páginas, el inicio de sesión y la escritura de datos.
6. Apunta un registro A a la dirección IP del servidor y dile a la herramienta el nombre de dominio. El certificado se emite automáticamente.

También puedes hacer todo esto a mano en Coolify, como explica nuestra guía de Next.js. Tienes acceso root y, si lo prefieres, puedes gestionarlo todo desde el panel.

Evita que cada cambio salga en producción

Aquí hay un detalle propio de Bolt. Como envía cada cambio al repositorio, un webhook en main hace que cada prompt inicie una compilación nueva y que los experimentos a medias salgan en producción. Para evitarlo, haz clic en el icono de GitHub, usa Create new branch para trabajar en una rama aparte y fusiona en main cuando termines. El servidor solo vigila main, así que los visitantes ven la versión terminada.

¿Qué pasa con Bolt Database?

Bolt Database guarda tus datos, el inicio de sesión, el almacenamiento de archivos y las funciones de servidor en Bolt Cloud. Mover el código deja todo eso donde está, así que tú eliges qué hacer después.

Las claves de la página Secrets de Bolt son para sus funciones de servidor. El código que se ejecuta en tu servidor las lee de las variables de entorno, así que las introduces tú allí.

Preguntas frecuentes

¿Qué potencia necesita un servidor para un proyecto de Bolt.new?

La página de venta recomienda al menos 4 GB de RAM, 2 vCores y 40 GB de disco. Las compilaciones de Next.js exigen más memoria a medida que crece un proyecto: uno con 85 paquetes falló con 2 GB y se compiló con 4 GB, mientras que uno pequeño pasó con 2 GB. Si no basta, amplía desde tu panel.

¿Cuánto costará al mes?

El tamaño mínimo recomendado cuesta unos $6 al mes (IVA incluido), y fuera de Turquía pagas en dólares estadounidenses. La copia de seguridad diaria está incluida en el precio y el tráfico es ilimitado. Tu suscripción a Bolt va aparte y continúa si sigues desarrollando allí.

¿Cómo conecto mi dominio?

Apunta un registro A a la dirección IP del servidor, añade el dominio a la aplicación y publica de nuevo. El certificado se emite automáticamente. Nuestro artículo de ayuda explica el registro.

¿Cómo llega un cambio de Bolt al servidor?

Bolt lo envía a GitHub y, con un webhook, el servidor vuelve a compilar en cada push a la rama que vigila. Sin él, pulsa Redeploy en Coolify.

¿Puedo pasar la base de datos a PostgreSQL en Coolify?

Si tu código habla con la base de datos directamente por SQL, sí. Bolt Database también cubre el inicio de sesión, los archivos y las funciones de servidor, y PostgreSQL a secas no los sustituye si tu código depende de ellos. En ese caso, la ruta de Supabase requiere menos cambios de código.

Listo para usar en Seturack: Next.js, Coolify, Supabase.