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

Para publicar um projeto Bolt.new no seu próprio servidor, ligue o projeto ao GitHub ou transfira-o como 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 de o código estar no GitHub, pode publicar através de outro serviço à sua escolha. Se seguir o caminho do GitHub, pode continuar a trabalhar no Bolt e as suas alterações chegam sozinhas ao repositório.

O Bolt está focado em JavaScript. A sua stack suportada é Node.js no backend e frameworks para navegador no frontend, sem backends em Python ou PHP. Por isso, o seu projeto é muito provavelmente um projeto Node comum com um package.json, e não precisa de nada específico do Bolt para correr.

Como tirar o código do Bolt?

Através do GitHub

1. Abra o projeto, clique no ícone do GitHub no canto superior direito, inicie sessão com a sua conta do GitHub e conceda o acesso que for pedido.
2. Dê um nome ao repositório e prima Create repository.
3. O repositório começa privado, num ramo main. A partir daí, o Bolt envia-lhe todas as alterações.

Como zip

Clique no nome do projeto, em cima à esquerda, e depois em Download. Um zip é uma cópia única e não recebe as alterações posteriores feitas no Bolt. O servidor publica a partir de um repositório Git, por isso ainda teria de o pôr num. Descompactá-lo e executar npm install && npm run dev é uma forma rápida de ver o código a correr fora do Bolt.

Que tipo de projeto é?

O projeto decide as definições, por isso verifique as dependências no package.json. As linhas Next.js, Vite e Astro são definições que experimentámos com o Coolify num servidor real.

Se um projeto Vite encaminha as páginas no navegador, defina Site type como SPA na página General. Não o fazer é o motivo habitual de uma página aninhada devolver um 404 ao atualizar.

Passo a passo

1. Encomende um servidor na página do VPS Next.js. Esta opção vem com o Coolify, por isso publica a partir do mesmo painel mesmo que o seu projeto não seja Next.js.
2. Clone o repositório e execute npm run build. O código que corre na pré-visualização do Bolt ainda pode falhar uma compilação de produção, e é melhor descobri-lo antes de o servidor o fazer.
3. Abra a pasta numa ferramenta de programação como o Claude Code ou o Cursor. Copie a linha Cole na sua ferramenta de IA do separador Resumo do seu painel da Seturack e cole-a. A ferramenta lê as instruções e publica, acrescentando uma chave de implementação só de leitura para o repositório privado.
4. Dê-lhe as variáveis de ambiente que o seu código espera e mantenha os valores fora do código.
5. Quando chegar o endereço HTTPS, teste as páginas, o início de sessão e a escrita de dados.
6. Aponte um registo A para o endereço IP do servidor e diga à ferramenta o nome do domínio. O certificado é emitido automaticamente.

Também pode fazer tudo isto à mão no Coolify, como explica o nosso guia do Next.js. Tem acesso root, e pode gerir tudo a partir do painel se preferir.

Evitar que todas as alterações entrem no ar

Eis um pormenor específico do Bolt. Como envia todas as alterações para o repositório, um webhook no main faz com que cada prompt inicie uma nova compilação, e as experiências a meio entram no ar. Para o evitar, clique no ícone do GitHub, use Create new branch para trabalhar num ramo separado e faça o merge no main quando terminar. O servidor só vigia o main, por isso os visitantes veem a versão final.

O que acontece ao Bolt Database?

O Bolt Database guarda os seus dados, o início de sessão, o armazenamento de ficheiros e as funções de servidor no Bolt Cloud. Mover o código deixa tudo isso onde está, por isso escolhe o que vem a seguir.

As chaves da página Secrets do Bolt são para as suas funções de servidor. O código que corre no seu servidor lê-as a partir de variáveis de ambiente, por isso tem de as introduzir aí.

Perguntas frequentes

Que capacidade de servidor precisa um projeto Bolt.new?

A página de vendas recomenda pelo menos 4 GB de RAM, 2 vCores e 40 GB de disco. As compilações do Next.js exigem mais memória à medida que o projeto cresce: um com 85 pacotes falhou com 2 GB e compilou com 4 GB, enquanto um pequeno passou com 2 GB. Se não chegar, aumente a partir do painel.

Quanto vai custar por mês?

O tamanho mínimo recomendado custa cerca de $6 por mês (IVA incluído) e, fora da Turquia, paga em dólares norte-americanos. As cópias de segurança diárias estão incluídas no preço e o tráfego é ilimitado. A sua subscrição do Bolt é à parte e mantém-se se continuar a desenvolver lá.

Como ligo o meu domínio?

Aponte um registo A para o endereço IP do servidor, adicione o domínio à aplicação e publique de novo. O certificado é emitido automaticamente. O nosso artigo de ajuda explica o registo.

Como chega ao servidor uma alteração feita no Bolt?

O Bolt envia-a para o GitHub e, com um webhook, o servidor recompila a cada push no ramo que vigia. Sem webhook, prima Redeploy no Coolify.

Posso mover a base de dados para o PostgreSQL no Coolify?

Se o seu código fala com a base de dados diretamente por SQL, sim. O Bolt Database também cobre o início de sessão, os ficheiros e as funções de servidor, e o PostgreSQL simples não os substitui se o seu código depender deles. Nesse caso, o caminho do Supabase exige menos alterações ao código.

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