Fazer deploy
docs

Volumes

Armazenamento persistente para serviços que precisam manter arquivos entre deploys.

Volumes são discos persistentes que ficam montados em um caminho do seu serviço. Diferente do filesystem padrão (efêmero, perdido a cada deploy), o volume sobrevive a redeploys, restarts e à atualização da imagem do serviço.

Quando usar

A maioria dos apps não precisa de volume:

  • Uploads de usuários, imagens, PDFs e arquivos gerados: use Blob Storage. Funciona com várias instâncias, sobrevive a deploys e entrega os arquivos pela CDN.
  • Dados estruturados: use os bancos gerenciados. Eles já vêm com armazenamento persistente, backup e túnel local.

Volumes são para softwares que exigem um diretório no disco local:

  • Repositórios Git auto-hospedados (Gitea)
  • SQLite ou bancos embedded
  • Cache de modelos IA e arquivos grandes lidos do disco
  • Dados de apps como Uptime Kuma, n8n etc.

Importante: um serviço com volume fica limitado a 1 instância, e cada deploy desliga a versão anterior antes de ligar a nova, com alguns segundos de indisponibilidade. Se o seu app só precisa guardar arquivos, Blob Storage evita as duas limitações.

Criar um volume

veloz volumes create dados --service api --mount /data --size 10Gi

Argumentos:

  • dados — nome do volume (único por projeto)
  • --service api — qual serviço vai montar o volume
  • --mount /data — caminho dentro do serviço onde será montado
  • --size 10Gi — tamanho inicial do volume

O volume passa a estar disponível em /data no próximo deploy do serviço. Tudo que você escrever lá persiste.

Listar volumes

veloz volumes list
veloz volumes list --service api

Mostra nome, serviço, mount path, tamanho atual, status e idade.

Expandir

Volumes só crescem — não dá para encolher (limitação técnica do storage).

veloz volumes expand dados --size 20Gi

A expansão é online: o volume é redimensionado sem desmontar. O próximo restart do serviço já enxerga o tamanho novo.

Sincronizar

Se você editou volumes diretamente no dashboard ou via outro lugar, force o serviço a aplicar:

veloz volumes sync

Apagar

veloz volumes delete dados

Aviso: os dados são mantidos por 30 dias após delete, caso você precise recuperar. Para apagar imediatamente, use o dashboard.

Limites e tamanhos

  • Mínimo: 10 GiB (limite do provedor de storage)
  • Máximo recomendado: 500 GiB por volume
  • Múltiplos volumes por serviço: sim, com mount paths diferentes
  • Múltiplos serviços por volume: não — cada volume é dedicado a um serviço

Custos

R$0,50/GiB/mês, calculado proporcionalmente à hora.

→ Veja a tabela de preços completa

Próximos passos