Skip to content

Conversation

@clayauld
Copy link

@clayauld clayauld commented Jan 6, 2026

This change migrates the S3 backend of the Notesnook stack from MinIO to GarageHQ (v2.1.0).

It includes:

  1. docker-compose.garage.yml: The updated Docker Compose file with the Garage service configured to generate its own config on startup (avoiding volume mounts for config). It sets up ports 3900 (S3), 3901 (RPC), and 3902 (Web).
  2. MIGRATION.md: A comprehensive guide detailing the migration process, including:
    • Generating RPC secrets.
    • Deploying the new stack.
    • Running the specific garage layout and bucket commands via SSH.
    • Applying a permissive CORS policy using a temporary AWS CLI container.
    • Updating the Notesnook server configuration.
  3. Upgrade MongoDB to v8
  4. Creation of a setup script for new installations.

This setup ensures full compatibility with the Notesnook web app by enabling website access and CORS on the attachments bucket.

google-labs-jules bot and others added 5 commits January 2, 2026 22:22
- Replaced `notesnook-s3` (MinIO) with `garage` service in docker-compose.
- Configured Garage for single-node operation via generated `garage.toml`.
- Added `MIGRATION.md` with step-by-step instructions for initialization, key generation, and CORS setup.
- Updated `notesnook-server` environment variables to point to the new Garage service.
- Ensured non-interactive compatibility for initialization commands.
…DB 8.0 support

- Replaced `notesnook-s3` (MinIO) with `garage` service in docker-compose.
- Updated `notesnook-db` to `mongo:8.0` for fresh installs.
- Added `MIGRATION.md` with step-by-step instructions for initialization, key generation, bucket aliasing, and CORS/Public Policy setup.
- Added `MONGO_UPGRADE.md` guide for safely upgrading existing MongoDB 7.0 instances to 8.0.
- Configured Garage via generated `garage.toml` to avoid host mounts.
- Updated `notesnook-server` environment variables to point to the new Garage service.
- Ensured Cloudflare and Public Access instructions are explicit for correct image loading.
…e migration guide to reflect this change and improve command output.
Replace MinIO with GarageHQ S3 for Notesnook. Upgrade MongoDB to v8
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant