Blossom can manage databases using Docker containers within your cluster. These databases are automatically configured and integrated with your applications.
Creating a Database
- Navigate to the Services page
- Click “Create New Service”
- Select a database type (PostgreSQL, MySQL, MariaDB, Redis, or Memcached)
- Configure the database settings:
- Name: A friendly name for your database
- Password: Set a secure password (or let Blossom generate one)
- Port: Choose a port for external access
Linking to Applications
Blossom automatically manages environment variables for database connections. When you link a database to an app:
- Go to your app’s settings
- Click “Link Another Service or Database”
- Select your database from the list
- The following environment variables will be automatically set:
- For PostgreSQL:
DATABASE_URL=postgresql://user:pass@host:port/dbname
- For MySQL/MariaDB:
DATABASE_URL=mysql2://user:pass@host:port/dbname
- For Redis:
REDIS_URL=redis://host:port
- For Memcached:
MEMCACHED_URL=memcached://host:port
- For PostgreSQL:
Backup and Recovery
For databases that support backups (PostgreSQL, MySQL, MariaDB):
- Navigate to the database details page
- Use the “Create Backup” button to create a manual backup
- Backups are stored in your cluster’s backup location
Limitations
Blossom-managed databases:
- Run as single instances (no automatic replication)
- Depend on the underlying server’s storage
- May require manual backup management
- Are tied to the server’s lifecycle
For production workloads requiring high availability or automatic scaling, consider using External Databases.