Django

Seu Django no ar, com as migrations rodando sozinhas.

gunicorn, Postgres gerenciado e HTTPS, sem configurar nginx nem systemd. 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 costuma travar o primeiro deploy de Django.

Migration que não rodou, banco sem backup e segredo no repositório.

Migrations a cada deploy

O campo antesDeIniciar roda o migrate antes de a versão nova entrar no ar. Falhou, a anterior continua atendendo.

Postgres gerenciado

Na mesma rede do app, com backup diário guardado por 7 dias. Você baixa e restaura pelo painel.

HTTPS pronto

Endereço nome.lumahost.app com certificado, e domínio próprio com certificado automático.

Variáveis para segredos

SECRET_KEY, DATABASE_URL e ALLOWED_HOSTS ficam nas variáveis do app, fora do repositório.

Deploy pelo GitHub

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

Comandos avulsos

createsuperuser, showmigrations e o seu management command rodam em Executar uma vez, com a saída no painel.

Como sobe

Do repositório ao admin no ar.

  1. 01

    Ajuste o settings

    Leia SECRET_KEY, DATABASE_URL, ALLOWED_HOSTS e CSRF_TRUSTED_ORIGINS de variáveis de ambiente.
  2. 02

    Crie o lumahost.json

    Diga a porta, o comando do gunicorn e o que roda antes de iniciar: migrate e collectstatic.
  3. 03

    Ligue o Postgres

    Crie o banco no painel e copie a URL interna para DATABASE_URL, com sslmode=disable.
  4. 04

    Mande o código

    Pelo GitHub, por .zip ou pelo MCP. O build lê o requirements.txt e o app sobe com HTTPS.
lumahost.json
{
  "tipo": "web",
  "porta": 8000,
  "start": "gunicorn meusite.wsgi --bind 0.0.0.0:8000",
  "antesDeIniciar": "python manage.py migrate && python manage.py collectstatic --noinput"
}

# no settings.py, tudo vem das variáveis do app:
# ALLOWED_HOSTS = os.environ["ALLOWED_HOSTS"].split(",")
# CSRF_TRUSTED_ORIGINS = os.environ["CSRF_TRUSTED_ORIGINS"].split(",")
# SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")
# DATABASES = {"default": dj_database_url.config()}

VPS ou PaaS

Por que Django dá trabalho numa VPS.

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

Numa VPS, você instala Python, configura o gunicorn no systemd, monta o nginx na frente, emite o certificado, instala o Postgres e cria a rotina de backup. Depois, a cada deploy, entra por SSH para rodar o migrate. Funciona, e o custo escondido é o tempo e o dia em que alguém esquece a migration.

Os PaaS de fora resolvem boa parte disso, com cobrança em dólar, em geral no cartão. Na LumaHost Cloud, o build sai do requirements.txt, a migration roda antes da versão nova entrar no ar e o Postgres tem backup diário. Preço fixo em reais, em Pix ou cartão.

Sem letra miúda

O que você precisa saber antes.

Preferimos dizer agora a você descobrir com o deploy no ar.
  • Uma migration quebrada só aparece como deploy falho quando acaba o prazo de 5 minutos do antesDeIniciar. A saída do comando fica no fim do log do deploy.
  • O antesDeIniciar não vale com Dockerfile. Com Dockerfile, coloque o migrate no próprio CMD.
  • Não existe terminal no container. Comandos avulsos, como createsuperuser, rodam em Executar uma vez.
  • Arquivos enviados pelos usuários (MEDIA_ROOT) somem a cada deploy, a não ser que fiquem na pasta persistente, que não tem backup.
  • Acesso ao Postgres da sua máquina ainda não está disponível. Para olhar os dados, use o console do banco no painel ou o próprio admin do Django.
  • Os servidores ficam em datacenter na Europa.

Quanto custa

Preço fixo em reais, app e banco no mesmo plano.

Pix ou cartão. O app começa em 256 MB de RAM e o Postgres em 512 MB, os dois do mesmo pool. Cabem juntos no plano Hobby, de R$ 14,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 rodo o python manage.py migrate sem terminal?

Coloque o comando no campo antesDeIniciar do lumahost.json. Ele roda a cada deploy, no container novo, com as variáveis do app, antes de a versão nova receber visitas. Se a migration falhar, o deploy falha e a versão anterior continua no ar. O comando tem até 5 minutos para terminar.

E o collectstatic?

Junte ao antesDeIniciar, depois da migration: python manage.py migrate && python manage.py collectstatic --noinput. Para servir os arquivos sem um nginx na frente, use o WhiteNoise no Django, que é o caminho comum quando o gunicorn atende sozinho.

Recebo DisallowedHost ou erro de CSRF no login. O que falta?

O endereço do app precisa estar no ALLOWED_HOSTS, e a origem com https:// no CSRF_TRUSTED_ORIGINS. O HTTPS termina na plataforma e chega ao app como HTTP, então defina SECURE_PROXY_SSL_HEADER com o cabeçalho X-Forwarded-Proto para o Django saber que a visita veio por HTTPS. Leia os três de variáveis de ambiente para não fixar o domínio no código.

Em qual porta o gunicorn tem que escutar?

Na porta que você informar em porta no lumahost.json, em 0.0.0.0. A plataforma entrega a mesma porta na variável PORT. Escutar só em 127.0.0.1 faz o deploy passar e o endereço não responder.

Como ligo o Postgres?

Crie o Postgres gerenciado no painel, copie a URL interna para a variável DATABASE_URL e leia no settings, por exemplo com dj-database-url. A URL interna não usa TLS: termine com sslmode=disable, senão a conexão é recusada.

Posso usar SQLite em vez de Postgres?

Pode, desde que o arquivo do banco fique na pasta persistente (/data). Fora dela, o disco do app é refeito a cada deploy e o banco some junto. A pasta persistente não tem backup diário; o Postgres tem.

E o Celery?

O worker do Celery sobe como um segundo app, do tipo worker, sem porta, apontando para um Redis gerenciado. Lembre que o Redis não tem backup: use como fila e cache, não como lugar de guardar dado.

Continue lendo

Guias e documentação.

Outros guias

Seu Django, no ar hoje.

Escolha um plano, suba o projeto e, se não for o que esperava, devolvemos o dinheiro em até 30 dias.

30 dias de garantia, reembolso via Pix. Sem fidelidade.