Blossom can manage databases using Docker containers within your cluster. These databases are automatically configured and integrated with your applications.

Creating a Database

  1. Navigate to the Services page
  2. Click “Create New Service”
  3. Select a database type (PostgreSQL, MySQL, MariaDB, Redis, or Memcached)
  4. 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:

  1. Go to your app’s settings
  2. Click “Link Another Service or Database”
  3. Select your database from the list
  4. 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

Backup and Recovery

For databases that support backups (PostgreSQL, MySQL, MariaDB):

  1. Navigate to the database details page
  2. Use the “Create Backup” button to create a manual backup
  3. 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.