Sua API FastAPI no ar, com Postgres e Redis do lado.
O que vem pronto
O que uma API em produção precisa.
HTTPS na frente
Postgres e Redis
Alembic a cada deploy
Worker para a fila
Métricas e logs
Deploy pelo GitHub
Como sobe
Do main.py à API respondendo.
01
Fixe a porta
Escreva a porta no lumahost.json e use a mesma no comando do uvicorn, em 0.0.0.0.02
Ligue os bancos
Crie Postgres e, se precisar, Redis no painel. Copie as URLs internas para as variáveis do app.03
Migre no deploy
alembic upgrade head no antesDeIniciar. O banco fica pronto antes da primeira requisição.04
Mande o código
Pelo GitHub, por .zip ou pelo MCP. O build lê o requirements.txt e a API sobe com HTTPS.
{
"tipo": "web",
"porta": 8000,
"start": "uvicorn main:app --host 0.0.0.0 --port 8000",
"antesDeIniciar": "alembic upgrade head"
}
# variáveis do app, com as URLs internas do painel:
# DATABASE_URL=postgresql+asyncpg://...?ssl=disable
# REDIS_URL=redis://...VPS ou PaaS
Por que API em VPS vira trabalho de servidor.
Numa VPS, você instala Python, deixa o uvicorn rodando no systemd, monta um proxy com certificado, instala Postgres e Redis e cria a rotina de backup. Cada atualização do sistema e cada disco cheio passam a ser seus.
Os PaaS de fora resolvem boa parte disso, com cobrança em dólar, em geral no cartão. Na LumaHost Cloud, a API, o Postgres e o Redis ficam na mesma rede, no mesmo pool de RAM, com preço fixo em reais, em Pix ou cartão. Você vê CPU e RAM de cada app e ajusta os workers pelo que mediu.
Sem letra miúda
O que você precisa saber antes.
- O start não aceita $PORT nem outras variáveis. Escreva a porta no comando e a mesma porta em porta no lumahost.json.
- Redis não tem backup. Use para cache e fila, não para guardar dado que importa.
- Acesso aos bancos da sua máquina ainda não está disponível. Para consultar, use o console do banco no painel.
- Cada worker do uvicorn ocupa RAM. O app tem limite rígido de memória e é encerrado se passar dele.
- O antesDeIniciar não vale com Dockerfile. Com Dockerfile, coloque a migration no próprio CMD.
- Os servidores ficam em datacenter na Europa. Se a API depende de latência muito baixa para o Brasil, fale com o suporte antes.
Quanto custa
Preço fixo em reais, API e bancos no mesmo plano.
Hobby
R$ 14,90/mês
1 GB de RAM, até 1 vCPU, 10 GB de disco
Dev
R$ 24,90/mês
2 GB de RAM, até 2 vCPU, 20 GB de disco
Pro
R$ 44,90/mês
4 GB de RAM, até 3 vCPU, 40 GB de disco
Studio
R$ 79,90/mês
8 GB de RAM, até 4 vCPU, 80 GB de disco
Apps ilimitados dentro da RAM do plano. Bancos gerenciados saem do mesmo pool (mínimo 512 MB cada) e têm backup diário de 7 dias, menos o Redis. No anual, dois meses saem de graça.
Dúvidas
Perguntas frequentes
Como fica o comando do uvicorn?
uvicorn main:app --host 0.0.0.0 --port 8000, com a mesma porta em porta no lumahost.json. A plataforma entrega essa porta na variável PORT. Escutar só em 127.0.0.1 faz o deploy passar e a API não responder.
Quantos workers eu coloco?
Depende da CPU do app, que acompanha a RAM: 1 vCPU por GB alocado, até o teto do plano. Cada worker é uma cópia da API na memória, então mais workers pedem mais RAM. Com rotas async, um worker já atende muitas requisições ao mesmo tempo; comece com um e aumente olhando as métricas de CPU e RAM no painel.
Como rodo as migrations do Alembic?
Coloque alembic upgrade head no campo antesDeIniciar do lumahost.json. Ele roda a cada deploy, no container novo, antes de a versão nova receber requisições. Se falhar, o deploy falha e a versão anterior continua no ar. O comando tem até 5 minutos.
O Postgres recusa a conexão. O que é?
Quase sempre TLS. A URL interna do banco não usa TLS, então desligue na conexão: sslmode=disable na URL do psycopg, ou ssl=disable com asyncpg pelo SQLAlchemy. Se o código exige TLS em produção, abra uma exceção para o banco interno.
Onde rodo tarefas em segundo plano?
O BackgroundTasks do FastAPI roda dentro do mesmo processo e se perde se ele reiniciar. Para fila de verdade (arq, Celery, RQ), suba um segundo app do tipo worker, sem porta, lendo o mesmo Redis gerenciado.
O deploy derruba a API por alguns segundos?
Sem pasta persistente, não: a versão nova sobe e a antiga só sai depois que a nova responde. Com pasta persistente, o padrão é deploy com pausa, para não ter duas cópias gravando na mesma pasta, e dá para mudar isso no lumahost.json.
A documentação em /docs fica pública?
Fica, como em qualquer lugar: o FastAPI publica /docs e /redoc por padrão. Se a API não é pública, desligue com docs_url=None e redoc_url=None, ou proteja as rotas.
Continue lendo
Guias e documentação.
Outros guias
- Hospedar app do Lovable, Bolt ou v0
Do zip exportado ao domínio próprio, com banco.
- Hospedagem Node.js, Python, Go e PHP
Build automático ou Dockerfile, com bancos gerenciados.
- Hospedar bot e agente de IA 24/7
Worker sem porta, a partir de 256 MB de RAM.
- Alternativa à Vercel, Railway e Render
Comparação honesta para quem está no Brasil.
- Alternativa open source ao n8n
Activepieces em um clique, com Postgres e Redis.
- Hospedar Evolution API
API de WhatsApp em um clique, com Postgres e backup.
- Hospedar OpenClaw e Hermes Agent
Agente de IA 24/7 com memória persistente.
- Hospedar bot de WhatsApp
Baileys 24/7, sem perder a sessão no deploy.
- Hospedar bot de Telegram
Worker em Python ou Node, template de 1 clique.
- Hospedar Open WebUI
Seu ChatGPT privado, com a sua chave de IA.
- Banco de dados gerenciado
Postgres, MySQL, Redis e MongoDB com backup.
- Hospedar Django
Migrations, estáticos e Postgres sem VPS.
- Hospedar Flask
gunicorn e SQLite que não some no deploy.
Sua API, no ar hoje.
Escolha um plano, suba a API e, se não for o que esperava, devolvemos o dinheiro em até 30 dias.
30 dias de garantia, reembolso via Pix. Sem fidelidade.