FastAPI

Sua API FastAPI no ar, com Postgres e Redis do lado.

uvicorn, HTTPS, bancos gerenciados e migrations do Alembic a cada deploy, sem montar servidor. A partir de R$ 14,90 por mês, em Pix ou cartão.

30 dias de garantia · Pix ou cartão · sem fidelidade

O que vem pronto

O que uma API em produção precisa.

HTTPS, banco com backup, fila separada e números para dimensionar.

HTTPS na frente

Endereço nome.lumahost.app com certificado, e domínio próprio como api.suaempresa.com.br.

Postgres e Redis

Na mesma rede da API, pela URL interna. Postgres com backup diário guardado por 7 dias.

Alembic a cada deploy

O antesDeIniciar roda o upgrade antes de a versão nova atender. Falhou, a anterior continua no ar.

Worker para a fila

arq, Celery ou RQ num app sem porta, a partir de 256 MB de RAM.

Métricas e logs

CPU e RAM por app e logs no painel, para dimensionar workers sem chutar.

Deploy pelo GitHub

Cada push na branch vira um deploy. Também dá por .zip ou pelo MCP no Claude Code e no Cursor.

Como sobe

Do main.py à API respondendo.

  1. 01

    Fixe a porta

    Escreva a porta no lumahost.json e use a mesma no comando do uvicorn, em 0.0.0.0.
  2. 02

    Ligue os bancos

    Crie Postgres e, se precisar, Redis no painel. Copie as URLs internas para as variáveis do app.
  3. 03

    Migre no deploy

    alembic upgrade head no antesDeIniciar. O banco fica pronto antes da primeira requisição.
  4. 04

    Mande o código

    Pelo GitHub, por .zip ou pelo MCP. O build lê o requirements.txt e a API sobe com HTTPS.
lumahost.json
{
  "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.

O código é o mesmo. Muda quem cuida do resto.

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.

Preferimos dizer agora a você descobrir em produção.
  • 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.

Pix ou cartão. A API começa em 256 MB de RAM e cada banco em 512 MB, todos do mesmo pool. API, Postgres e Redis cabem juntos a partir do plano Dev, de R$ 24,90 por mês.

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

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.