Publicar um app do Replit na Zenifra
Você pode continuar criando o app no Replit e publicar na Zenifra. O código vai para um repositório no GitHub, e a Zenifra faz o build e publica a partir dele. Quase tudo o que o console da Zenifra pede já está no arquivo .replit do projeto.
1. Envie o código para o GitHub
No Replit, ligue a sua conta GitHub nos serviços conectados da conta. Depois, abra a ferramenta Git no projeto e conecte um repositório:
- Para enviar as mudanças, faça commit e clique em Push no painel Git.
- Para que o repositório acompanhe o Replit sem cliques, ative o auto-sync no painel Git. Ele sincroniza nos dois sentidos.
- Se a sincronização parar, reconecte o GitHub nos serviços conectados. O Replit recomenda um token de acesso pessoal fine-grained para uma conexão mais estável.
Detalhes na documentação do Replit sobre Git.
2. Copie a configuração do arquivo .replit
O .replit fica na raiz do repositório. Um app Node.js criado pelo Agent costuma ter algo assim:
modules = ["nodejs-20", "web", "postgresql-16"]
[deployment]
deploymentTarget = "autoscale"
build = ["npm", "run", "build"]
run = ["npm", "run", "start"]
[[ports]]
localPort = 5000
externalPort = 80
[env]
PORT = "5000"Cada parte vira um campo do console da Zenifra:
No .replit | No console da Zenifra | No exemplo |
|---|---|---|
modules: nodejs-20, python-3.11 etc. | Runtime e Versão | Node.js, versão 20 |
[deployment] › build | Comando Build, com as partes unidas por espaço | npm run build |
[deployment] › run | Comando Start | npm run start |
[[ports]] › localPort | Porta | 5000 |
[env] | Variáveis de Ambiente | PORT=5000 |
modules: postgresql-16 | Um PostgreSQL gerenciado, na etapa 4 | DATABASE_URL |
Se o [deployment] não tem build, deixe o Comando Build vazio. Se o run é ["sh", "-c", "cd main && python app.py"], use cd main && python app.py no Comando Start, ou preencha Diretório raiz com main e use python app.py.
A Zenifra oferece Node.js 20, 22, 24 e 26 e Python 3.11, 3.12, 3.13 e 3.14. Veja Runtimes.
Segredos do Replit
Os valores da ferramenta Secrets do Replit não vão para o GitHub. Abra Secrets no Replit e cadastre cada um em Variáveis de Ambiente na Zenifra. O DATABASE_URL do banco do Replit não aparece em Secrets; na Zenifra, ele vem do banco novo, na etapa 4.
3. Crie o projeto na Zenifra
No console, clique em + Criar projeto, escolha Aplicação HTTP e o plano. Em Origem e porta, escolha Repositório Git em Origem do Projeto, o Provedor Git GitHub, o repositório e a branch. Se for a primeira vez, conecte sua conta GitHub e instale o GitHub App da Zenifra no repositório.
Preencha os campos com a tabela da etapa 2. No runtime Node.js, a Zenifra instala as dependências com npm ci, que precisa de um package-lock.json no repositório. Os apps Node.js do Replit costumam já ter esse arquivo; veja Dependências Node.js.
A aplicação precisa escutar em 0.0.0.0 e na porta do projeto. Os apps do Agent já leem a variável PORT. Por isso, cadastre PORT com o mesmo valor da Porta.
4. Leve o banco de dados
Se o .replit tem um módulo postgresql-*, o app usa o PostgreSQL do Replit pela variável DATABASE_URL.
- Crie um PostgreSQL gerenciado na mesma organização.
- Copie a URI de conexão do banco e cadastre-a como
DATABASE_URLno projeto da aplicação. Veja Conectar ao banco. - Copie os dados do banco de produção do Replit com
pg_dumpepg_restore, como em Migrar o banco de dados. Para a URI de origem, abra a ferramenta Database do Replit, escolha o banco de produção e copie o Connection string da aba Settings.
Confira o arquivo de conexão, normalmente server/db.ts. Apps mais antigos do Replit usam o driver @neondatabase/serverless, que conecta por WebSocket ao proxy da Neon e não funciona com um PostgreSQL comum. Troque pelo pg com o Drizzle:
import pg from 'pg'
import { drizzle } from 'drizzle-orm/node-postgres'
import * as schema from '@shared/schema'
export const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL })
export const db = drizzle({ client: pool, schema })Instale o driver com npm install pg e faça commit do package.json e do package-lock.json.
5. Publique e teste
Ao criar o projeto, a primeira build começa na hora. Acompanhe em Logs de build e, quando terminar, abra a URL do projeto. Teste uma tela que lê do banco e uma que grava. Depois disso, cada push no GitHub publica uma nova versão; veja Deploy automático.
Recursos do Replit
Alguns recursos usados por apps do Replit são serviços do próprio Replit:
- Replit Auth: o login usa a conta Replit de quem acessa. Antes de trocar o domínio, confirme na documentação do Replit se o login do seu app funciona fora do Replit, ou troque por um login próprio.
- App Storage: os arquivos ficam no armazenamento do Replit. Para guardar arquivos na Zenifra, use o Armazém, compatível com S3.
- Tarefas agendadas: viram Jobs agendados.
Domínio próprio
Quando o app estiver funcionando pela URL da Zenifra, aponte o seu domínio para o projeto. Veja Domínios personalizados.
Problemas comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| A build falha na instalação das dependências | Repositório sem package-lock.json ou com o arquivo fora de sincronia | Rode npm install localmente e faça commit do package-lock.json |
| A aplicação não passa na verificação de saúde | A Porta é diferente da porta em que o app escuta | Use o localPort do .replit na Porta e em PORT |
O app encerra com DATABASE_URL must be set | Falta a variável do banco | Cadastre DATABASE_URL com a URI do PostgreSQL gerenciado |
| Erro de WebSocket ao conectar no banco | Driver @neondatabase/serverless | Troque pelo pg, como na etapa 4 |
Última atualização em
Publicar um app do Lovable na Zenifra
Publique na Zenifra um app criado no Lovable: sincronize com o GitHub, use o runtime Bun com NITRO_PRESET e o Supabase, e receba cada mudança no ar sozinha.
Runtimes
Conheça os runtimes Node.js, Python, Bun, Go, Java e PHP disponíveis para projetos Git na Zenifra e como funcionam a instalação, o build e a inicialização.