Skip to content

v2.0.0

Choose a tag to compare

@sneg55 sneg55 released this 04 Nov 18:01
· 6 commits to main since this release

Breaking: object storage moves from MinIO to Garage

Public registries no longer serve MinIO images, so the bundled stack now runs Garage (dxflrs/garage:v2.5.0) for file storage.

Before you upgrade an existing install:

  1. Add GARAGE_RPC_SECRET to .env (openssl rand -hex 32). Compose refuses to start without it.
  2. Garage needs an access key of at least 8 characters and a secret of at least 16. If your MINIO_* keys are shorter (for example minioadmin/minioadmin), add new S3_ACCESS_KEY and S3_SECRET_KEY values and keep the MINIO_* lines for the copy step.
  3. Copy your existing files out of the old miniodata volume. Garage starts empty, so older attachments fail to download until you do.

The full procedure, including the rclone copy command, is in Updating, Upgrading from MinIO.

Environment: storage variables are now S3_ENDPOINT, S3_ACCESS_KEY, S3_SECRET_KEY, S3_BUCKET and S3_REGION. Each one falls back to its MINIO_* name, so you don't have to rename anything. When S3_ENDPOINT points at an external S3 store, leave S3_REGION unset (bucket-region discovery still works) or set it to that store's region.

Full Changelog: v1.4.1...v2.0.0