Primeiros passos

Três jeitos de colocar um app no ar. Escolha o que combina com o seu fluxo, todos chegam no mesmo lugar.

Antes de tudo

Você precisa de um plano, de CPF ou CNPJ no cadastro e do primeiro pagamento confirmado. Nenhum app sobe antes disso, e não existe plano grátis.

1. Por arquivo .zip

É o caminho mais curto para quem exportou um projeto do Lovable, do Bolt ou de outro gerador.

  1. No painel, clique em Novo app e escolha Enviar .zip.
  2. Dê um nome. Ele vira o endereço nome.lumahost.app.
  3. Escolha a RAM do app (mínimo 256 MB). Ela sai do pool do seu plano.
  4. Envie o zip, com até 100 MB.
Não precisa incluir node_modules nem .git. Zip menor sobe mais rápido. Deixe o código na raiz do zip, e não dentro de uma subpasta.

2. Pelo GitHub

Instale o aplicativo da LumaHost nos repositórios que você quiser publicar e escolha o repositório e a branch ao criar o app. Cada push na branch vira um deploy novo.

Nós só lemos os repositórios que você liberar na instalação. Dá para tirar o acesso a qualquer momento nas configurações do GitHub.

3. Pelo MCP

Com o MCP, o seu assistente (Claude Code, Cursor) sobe a pasta do projeto por você. Veja a página MCP.

claude mcp add lumahost -e LUMAHOST_TOKEN=lh_... -- npx -y @lumahost/mcp

Depois do envio

O deploy entra numa fila de build. O painel mostra a sua posição e o log em tempo quase real. O build tem limite de 15 minutos. Quando termina, o app aparece como Rodando.

Não detectou o que você queria? Crie um lumahost.json na raiz para dizer o tipo, a porta e os comandos.