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 até a troca da imagem do container.

Quando usar

  • Diretórios de upload de usuários
  • Repositórios Git auto-hospedados (Gitea)
  • Armazenamento de SQLite ou bancos embedded
  • Cache de modelos IA / arquivos grandes
  • Dados de apps como Uptime Kuma, n8n etc.

Para banco de dados, use os bancos gerenciados (Bancos de dados). Eles já vêm com volume persistente, backup e túnel local. Volumes são para casos onde você precisa de filesystem direto.

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 container 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

⚠️ 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