Flask

Seu Flask no ar, sem perder o banco no deploy.

gunicorn, HTTPS e o SQLite numa pasta que sobrevive ao deploy, ou Postgres gerenciado com backup. 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 um Flask pequeno precisa para ficar no ar.

Servidor de produção, HTTPS e um lugar seguro para o banco.

Pasta que não some

A pasta persistente em /data guarda o SQLite e os uploads entre um deploy e outro.

Postgres, se precisar

Gerenciado, na mesma rede do app, com backup diário guardado por 7 dias.

HTTPS pronto

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

Snapshot antes de mexer

Um clique copia a pasta inteira, com o SQLite dentro, e guarda por 7 dias.

Variáveis para segredos

SECRET_KEY, chaves de API e a URL do banco ficam nas variáveis do app, fora do código.

Reinício automático

Se o processo cair, a plataforma sobe de novo, e o log mostra o que aconteceu antes.

Como sobe

Do app.py ao site no ar.

  1. 01

    Troque o servidor

    Adicione gunicorn ao requirements.txt e use-o no start, na porta do lumahost.json.
  2. 02

    Ligue a pasta

    volume: /data no lumahost.json, e o banco SQLite com caminho absoluto dentro dela.
  3. 03

    Mande o código

    Pelo GitHub, por .zip ou pelo MCP. O build lê o requirements.txt e o site sobe com HTTPS.
  4. 04

    Confira os dados

    Faça um deploy de teste e veja que o banco continua lá. Antes de mudança grande, tire um snapshot.
lumahost.json
{
  "tipo": "web",
  "porta": 8000,
  "start": "gunicorn app:app --bind 0.0.0.0:8000",
  "volume": "/data"
}

# no app.py, o SQLite vai para a pasta persistente:
# app.config["SQLALCHEMY_DATABASE_URI"] = "sqlite:////data/app.db"

O erro mais caro

SQLite fora da pasta persistente some a cada deploy.

Já vimos um cliente perder dados assim. Vale um minuto para conferir.

O disco do app é refeito a cada deploy. Um SQLite gravado na pasta do projeto, como o padrão do Flask-SQLAlchemy na pasta instance, funciona no primeiro dia e volta vazio no deploy seguinte. Só a pasta persistente fica. Por isso o caminho do banco precisa ser absoluto e começar por ela, como /data/app.db.

Numa VPS, o disco não some, mas você instala Python, configura o gunicorn no systemd, monta o proxy com certificado e cuida do backup. Nos PaaS de fora, a cobrança é em dólar, em geral no cartão. Na LumaHost Cloud, a pasta persistente é um campo no lumahost.json, e o 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 banco vazio.
  • A pasta persistente não tem backup diário. Faça snapshot antes de mudança arriscada e, se o dado é insubstituível, use o Postgres.
  • Excluir o app apaga a pasta persistente junto. Antes de excluir, a plataforma tira um snapshot.
  • Com a pasta ligada, o deploy é com pausa: o site fica alguns segundos fora do ar.
  • Não existe terminal no container. Para rodar um script no banco, use Executar uma vez, que enxerga a mesma pasta.
  • O start não aceita $PORT nem outras variáveis. Escreva a porta no comando e a mesma porta em porta no lumahost.json.
  • Os servidores ficam em datacenter na Europa.

Quanto custa

Preço fixo em reais, sem cobrança por visita.

Pix ou cartão. Um Flask com SQLite começa em 256 MB de RAM, e o plano Hobby, de R$ 14,90 por mês, já comporta. Com Postgres, o banco começa em 512 MB e sai do mesmo pool.

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

Por que meu SQLite voltou vazio depois do deploy?

Porque o arquivo do banco estava no disco do app, que é refeito a cada deploy. Ligue a pasta persistente em /data e aponte o banco para lá, por exemplo sqlite:////data/app.db (quatro barras: o caminho é absoluto). O que estiver em /data sobrevive a deploy e reinício.

SQLite ou Postgres?

SQLite na pasta persistente serve para projeto pequeno, com pouca escrita ao mesmo tempo. A pasta não tem backup diário: só o snapshot que você faz na hora, guardado por 7 dias. O Postgres gerenciado tem backup diário com 7 dias de retenção e aguenta vários workers escrevendo. Se o dado importa, vá de Postgres.

Posso usar o flask run ou o app.run()?

Não em produção. O servidor embutido do Flask é para desenvolvimento. Use o gunicorn: gunicorn app:app --bind 0.0.0.0:8000, com a mesma porta em porta no lumahost.json.

Como rodo as migrations do Flask-Migrate?

Coloque flask --app app db upgrade no campo antesDeIniciar do lumahost.json. Ele roda a cada deploy, no container novo, antes de a versão nova entrar no ar. Se falhar, o deploy falha. O comando tem até 5 minutos.

Quantos workers do gunicorn?

Com Postgres, ajuste pela CPU e pela RAM do app, olhando as métricas no painel. Com SQLite, poucos: o SQLite aceita um escritor por vez, e muitos workers gravando juntos dão "database is locked".

O site sai do ar no deploy?

Com pasta persistente, sai por alguns segundos: o padrão é deploy com pausa, que desliga a versão antiga antes de ligar a nova, para o SQLite não ter dois processos gravando ao mesmo tempo. Sem pasta persistente, a versão nova sobe antes de a antiga sair.

E os arquivos que os usuários enviam?

Grave os uploads em /data, a mesma pasta persistente do SQLite. Fora dela, somem no próximo deploy. Pela aba Arquivos do painel você navega, baixa e apaga o que está lá.

Continue lendo

Guias e documentação.

Outros guias

Seu Flask, 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.