Documentation
Volumes
Attach persistent volumes to services for stateful workloads, migrations, and backups.
When to use volumes
Volumes are ideal for file storage, cached assets, and data that should survive restarts. You can attach volumes to apps, workers, or databases to keep data persistent.
Volume lifecycle
- Create a volume from the project settings or service detail panel.
- Attach it to a service and choose a mount path.
- Resize or migrate volumes as your storage needs grow.
Snapshots and backups
Use snapshots for point in time recovery or to clone data into new environments. Volume snapshots are especially useful before large migrations or schema changes.
Best practices
- Mount volumes to clear, dedicated paths like /data or /var/lib/app.
- Keep backups of critical volumes before major releases.
- Test restores in staging before using a volume in production.