Storage

​

Volumes

​

Creating a Volume

1. Add a volume to the canvas
2. Set size (see plan limits below)
3. Drop the volume onto a service
4. Set the mount path
5. Deploy

​

Volume Constraints

• Services per volume: 1 (volumes cannot be shared between services)
• Replicas with volumes: 1 (required for data consistency)
• Size limits: vary by plan, see Plan Limits

​

Data Persistence

• Container restarts
• Redeployments
• Service crashes
• Rollbacks (data stays current, not rolled back)

• Volume is deleted
• Environment is deleted

​

Database Templates

​

PostgreSQL

Image: postgres:16-alpine
Port: 5432
Volume: /var/lib/postgresql/data
Environment:
  POSTGRES_USER: postgres
  POSTGRES_PASSWORD: [your password]
  POSTGRES_DB: postgres

postgresql://postgres:PASSWORD@postgres:5432/postgres

​

Redis

Image: redis:7-alpine
Port: 6379
Volume: /data
Command: redis-server --requirepass [password] --appendonly yes

redis://:PASSWORD@redis:6379

​

MariaDB

Image: mariadb:11
Port: 3306
Volume: /var/lib/mysql
Environment:
  MYSQL_ROOT_PASSWORD: [your password]
  MYSQL_DATABASE: mydb

mysql://root:PASSWORD@mariadb:3306/mydb

​

Connecting to Databases

// Node.js - PostgreSQL
const pool = new Pool({
  host: 'postgres',  // Service name
  port: 5432,
  password: process.env.DB_PASSWORD
});

// Node.js - Redis
const redis = new Redis({
  host: 'redis',
  port: 6379,
  password: process.env.REDIS_PASSWORD
});

​

Volume vs External Storage

• Running your own database
• Need direct filesystem access
• Storing small uploads or state

• Files exceed your plan’s storage limits
• Need to share files across services
• Require public CDN access
• Want automatic scaling

​

Common Questions