Como publicar um projeto do Bolt.new no seu próprio servidor

Para publicar um projeto do Bolt.new no seu próprio servidor, conecte o projeto ao GitHub ou baixe-o como um zip, entregue o código ao painel Coolify do seu servidor, defina as variáveis de ambiente e aponte o seu domínio para ele. A documentação do Bolt diz o mesmo: depois que o código está no GitHub, você pode publicar por outro serviço à sua escolha. Se seguir pelo GitHub, pode continuar trabalhando no Bolt e as suas mudanças chegam ao repositório sozinhas.

O Bolt tem foco em JavaScript. A stack compatível dele é Node.js no backend e frameworks para navegador no frontend, sem backends em Python ou PHP. Então o seu projeto provavelmente é um projeto Node comum com um package.json e não precisa de nada específico do Bolt para rodar.

Como tirar o código do Bolt?

Pelo GitHub

1. Abra o projeto, clique no ícone do GitHub no canto superior direito, entre com a sua conta do GitHub e conceda o acesso que ele pedir.
2. Dê um nome ao repositório e clique em Create repository.
3. O repositório começa como privado em uma branch main. A partir daí, o Bolt envia cada mudança para ele.

Como um zip

Clique no nome do projeto no canto superior esquerdo e depois em Download. Um zip é uma cópia única e não recebe mudanças posteriores no Bolt. O servidor publica a partir de um repositório Git, então você ainda precisaria colocá-lo em um. Descompactá-lo e executar npm install && npm run dev é um jeito rápido de ver o código rodar fora do Bolt.

Que tipo de projeto é?

O projeto decide as configurações, então confira as dependências no package.json. As linhas de Next.js, Vite e Astro são configurações que testamos com o Coolify em um servidor real.

Se um projeto Vite faz o roteamento das páginas no navegador, defina Site type como SPA na página General. Pular isso é o motivo habitual de uma página aninhada retornar 404 ao atualizar.

Passo a passo

1. Peça um servidor pela página do VPS Next.js. Essa opção vem com o Coolify, então você publica do mesmo painel mesmo que o seu projeto não seja Next.js.
2. Clone o repositório e execute npm run build. Um código que roda na prévia do Bolt ainda pode falhar em um build de produção, e é melhor descobrir isso antes que o servidor descubra.
3. Abra a pasta em uma ferramenta de código como o Claude Code ou o Cursor. Copie a linha Cole na sua ferramenta de IA da aba Visão geral do seu painel da Seturack e cole nela. A ferramenta lê as instruções e publica, adicionando uma deploy key somente leitura para o repositório privado.
4. Dê a ela as variáveis de ambiente que o seu código espera e mantenha os valores fora do código.
5. Quando o endereço HTTPS chegar, teste as páginas, o login e a gravação de dados.
6. Aponte um registro A para o endereço IP do servidor e diga o nome do domínio à ferramenta. O certificado é emitido automaticamente.

Você também pode fazer tudo isso à mão no Coolify, como explica o nosso guia do Next.js. Você tem acesso root e pode gerenciar tudo pelo painel, se preferir.

Evite que toda mudança vá ao ar

Aqui vai um detalhe específico do Bolt. Como ele envia cada mudança ao repositório, um webhook na main significa que cada prompt inicia um novo build, e experimentos pela metade vão ao ar. Para evitar isso, clique no ícone do GitHub, use Create new branch para trabalhar em uma branch separada e faça o merge na main quando terminar. O servidor só observa a main, então os visitantes veem a versão concluída.

O que acontece com o Bolt Database?

O Bolt Database guarda os seus dados, o login, o armazenamento de arquivos e as funções de servidor no Bolt Cloud. Mover o código deixa tudo isso onde está, então você escolhe o que vem a seguir.

As chaves da página Secrets do Bolt são para as funções de servidor dele. O código que roda no seu servidor as lê de variáveis de ambiente, então você mesmo as informa lá.

Perguntas frequentes

De que potência de servidor um projeto do Bolt.new precisa?

A página de vendas recomenda pelo menos 4 GB de RAM, 2 vCores e 40 GB de disco. Os builds do Next.js pressionam a memória conforme o projeto cresce: um com 85 pacotes falhou com 2 GB e foi compilado com 4 GB, enquanto um pequeno passou com 2 GB. Se não for suficiente, aumente pelo seu painel.

Quanto vai custar por mês?

O tamanho mínimo recomendado custa cerca de $6 por mês (impostos incluídos), e fora da Turquia você paga em dólares americanos. Os backups diários estão incluídos no preço e o tráfego é ilimitado. A sua assinatura do Bolt é separada e continua se você seguir desenvolvendo lá.

Como conecto o meu domínio?

Aponte um registro A para o endereço IP do servidor, adicione o domínio ao app e publique de novo. O certificado é emitido automaticamente. Nosso artigo de ajuda explica o registro.

Como uma mudança no Bolt chega ao servidor?

O Bolt a envia ao GitHub e, com um webhook, o servidor recompila a cada push na branch que ele observa. Sem um, clique em Redeploy no Coolify.

Posso mover o banco de dados para o PostgreSQL no Coolify?

Se o seu código fala com o banco de dados diretamente por SQL, sim. O Bolt Database também cobre login, arquivos e funções de servidor, e um PostgreSQL simples não vai substituí-los se o seu código depende deles. Nesse caso, o caminho pelo Supabase exige menos mudanças no código.

Pronto na Seturack: Next.js, Coolify, Supabase.