Pasta persistente
Por padrão, o disco do app é refeito a cada deploy. A pasta persistente é a exceção: o que o app grava nela continua lá.
Quando usar
- Sessão de bot de WhatsApp (Baileys, whatsapp-web.js), para não escanear o QR code a cada deploy.
- Banco SQLite de um projeto pequeno.
- Arquivos que os usuários enviam (uploads).
- Memória e configuração de agentes de IA.
Para dados importantes de verdade, prefira um banco gerenciado, que tem backup diário.
Como ligar
No console, ao criar o app, marque Pasta persistente e informe o caminho, como /data. Num app que já existe, use a aba Configurações. Também dá pelo lumahost.json:
{
"volume": "/data"
}A pasta passa a existir a partir do próximo deploy. No código, grave nela com o caminho absoluto (ex.: /data/sessao). Pelo MCP, peça para criar o app com volume em /data.
Ver e editar pelo painel
Na aba Arquivos do app, escolha Pasta persistente: navegue pelas pastas, abra e edite arquivos de texto, envie e baixe arquivos de até 10 MB, crie pastas e apague o que não serve mais. A mudança vale na hora, porque o app lê a mesma pasta. Na mesma aba, em Código, você edita o código do app e implanta sem reenviar o .zip.
Tamanho
O tamanho da pasta é o disco do app e sai do disco do seu plano. Aumentar vale na hora, sem reiniciar. Diminuir só até o que já está gravado. Quando a pasta enche, o app recebe o erro de disco cheio (ENOSPC ou EDQUOT) e os outros apps não são afetados. O console mostra quanto já está em uso.
Deploy com pausa
Num app sem pasta persistente, o deploy liga a versão nova e só desliga a antiga depois que a nova responde, sem tempo fora do ar. Com pasta persistente, isso deixaria as duas versões gravando na mesma pasta por alguns segundos: uma sessão de WhatsApp conectaria duas vezes (e cairia), e um SQLite teria dois escritores ao mesmo tempo.
Por isso, com a pasta ligada, o deploy e o reinício são com pausa: a versão antiga desliga antes de a nova ligar, e o app fica alguns segundos fora do ar. Dá para mudar em Configurações › No deploy, ou no lumahost.json com "deployComPausa": false, se o seu app aguenta duas cópias ao mesmo tempo (por exemplo, um site que só guarda uploads).
Regras
- Uma pasta por app. Site estático não tem pasta persistente.
- Mudar o caminho mantém os arquivos e vale no próximo deploy.
- Depois de ligada, a pasta só sai junto com o app: excluir o app apaga a pasta.
- O Executar uma vez enxerga a mesma pasta, no mesmo caminho.