Usando o ChatGPT para subir seu app

Você não precisa entender de servidor. O ChatGPT que fez o seu projeto também deixa ele pronto para a LumaHost Cloud, se receber as regras certas. O painel entrega essas regras prontas para copiar.

1. Antes do primeiro envio: peça para o ChatGPT preparar o projeto

  1. No painel, clique em Novo app e escolha o tipo: site ou sistema, robô ou automação, ou site só de arquivos.
  2. No quadro Fez o projeto com o ChatGPT?, diga a linguagem (ou deixe "Não sei") e clique em Copiar pedido para o ChatGPT.
  3. Cole na mesma conversa em que o ChatGPT fez o projeto. Ele devolve os arquivos ajustados e a lista das variáveis que você precisa criar.
  4. Troque os arquivos no seu projeto, gere o .zip como ele explicar e envie no painel.

O pedido muda conforme o tipo e a linguagem. Este é o de um site ou sistema quando você não sabe a linguagem:

Quero publicar este projeto na LumaHost Cloud. Ela recebe o projeto num arquivo .zip e monta o app sozinha (build automático com Nixpacks).
O app é um site ou sistema com endereço na internet (tipo web). Não sei a linguagem: descubra pelos arquivos.
Ajuste o projeto para seguir as regras abaixo. Me devolva cada arquivo que mudou, completo, e no fim um passo a passo curto do que eu faço no painel. Se faltar alguma informação (o arquivo de entrada do app, por exemplo), me pergunte antes de inventar.

Regras da LumaHost Cloud:
Se for JavaScript (Node):
- package.json na raiz, com o script "start" (e o script "build", se o projeto tem etapa de build).
- O servidor escuta na porta da variável PORT e no endereço 0.0.0.0, assim: app.listen(process.env.PORT || 3000, '0.0.0.0'). Nada de porta fixa nem de localhost.

Se for Python:
- requirements.txt na raiz, com todas as dependências, incluindo o servidor de produção: gunicorn (Flask, Django) ou uvicorn (FastAPI). O servidor embutido do Flask (app.run) não serve em produção.
- Um lumahost.json na raiz, assim (troque app:app pelo arquivo:variável do app): {"tipo": "web", "porta": 8000, "start": "gunicorn app:app --bind 0.0.0.0:8000"}. No FastAPI, o start é "uvicorn main:app --host 0.0.0.0 --port 8000".
- O start não aceita $ nem variáveis: a porta vai escrita no comando, e a mesma porta no campo "porta".

Variáveis, banco e arquivos:
- Senha, token e chave nunca ficam no código nem num arquivo .env dentro do zip: o código lê de variáveis de ambiente (process.env no Node, os.environ no Python). Me diga o nome de cada variável que eu preciso criar na aba Variáveis do app. Não crie a PORT: ela é da plataforma.
- Banco de dados, se o app usa um: o código lê a URL da variável DATABASE_URL. Eu crio o banco no painel (Bancos), copio a "URL interna" e colo numa variável DATABASE_URL do app. Essa conexão não usa SSL: no Postgres, termine a URL com ?sslmode=disable ou use ssl: false no cliente. Não exija SSL.
- O start não cria tabelas. Se o projeto tem migration, coloque o comando em "antesDeIniciar" no lumahost.json (por exemplo "npx prisma migrate deploy" ou "flask db upgrade"); com antesDeIniciar, o "start" também precisa estar no arquivo. Os dois juntos têm até 124 caracteres e só aceitam aspas duplas.
- Arquivo gravado no disco do app (SQLite, uploads, sessão de WhatsApp) some a cada deploy. Se o app precisa guardar arquivo, grave numa pasta como /data e me avise para ligar a "Pasta persistente" com esse caminho no painel.

O .zip:
- No fim, me ensine a gerar o .zip: o package.json ou o requirements.txt fica na raiz do zip, não dentro de outra pasta. Deixe de fora node_modules, venv ou .venv, .env, .git e __pycache__. O zip tem até 100 MB.
- Não precisa de Dockerfile e Docker Compose não é suportado: o build é automático (Nixpacks).

Documentação: https://lumahost.com/docs/cloud
O pedido também está no detalhe do app, na aba Deploys. Ele não leva nenhum dado seu: só as regras da plataforma.

2. Crie as variáveis antes de enviar

O ChatGPT vai listar nomes como DATABASE_URL ou OPENAI_API_KEY. Crie cada uma na aba Variáveis do app, com o valor de verdade. Não cole senha nem chave na conversa com o ChatGPT: ele só precisa do nome.

Usa banco de dados? Crie o banco em Bancos, copie a URL interna e cole numa variável DATABASE_URL do app. Detalhes em Bancos de dados.

3. O .zip certo

  • O package.json (Node) ou o requirements.txt (Python) fica na raiz do zip.
  • Fora do zip: node_modules, venv ou .venv, .env, .git e __pycache__. O .env tem as suas senhas: elas vão na aba Variáveis, não no zip.
  • Até 100 MB.

4. Deu erro? Copie o erro para o ChatGPT

Quando um deploy falha ou o app fica reiniciando em ciclo, o painel mostra o botão Copiar erro para o ChatGPT (na visão geral, no deploy que falhou e na aba Logs). Ele copia um texto com o tipo do app, o comando de início, a porta, os nomes das variáveis e o final do log, e pede a correção.

Antes de copiar, o painel tira do log o valor de todas as variáveis do app, as senhas de URLs de banco e tokens com formato conhecido (OpenAI, GitHub, Telegram, Discord, JWT). No lugar fica um marcador como <valor de DATABASE_URL> ou <REDACTED>. Mesmo assim, dê uma olhada antes de colar: se o seu app imprime dado de cliente no log, ele vai junto.

Cole na conversa, aplique o que ele sugerir e envie um novo .zip. Se a correção for no painel (uma variável faltando, o tipo do app), faça a mudança e reinicie o app. Os erros mais comuns, com a solução, estão em Erros comuns.

As regras que o ChatGPT precisa saber

Se preferir escrever do seu jeito, estas são as que mais derrubam deploy:

  • App web escuta em 0.0.0.0 na porta de PORT. No Python, a porta vai escrita no comando de início e no campo porta do lumahost.json. Veja Variáveis e a porta.
  • Robô (worker) não escuta porta e fica rodando sempre. Script que roda e termina vai em Executar uma vez.
  • A URL interna do banco não usa SSL: sslmode=disable.
  • Migration vai em antesDeIniciar, porque o start não cria tabelas.
  • Arquivo gravado no disco some a cada deploy, a não ser na pasta persistente.