Files
notesnook-sync-server_custo…/examples/external-minio/README.md
T
Ibaraki DoujiandGitHub 3c7327d3c7 docker: fix compose self-hosting and add external Mongo/MinIO/Garage examples (#106)
* docker: update .env and docker-compose.yml for SMTP and new services

* docker: add external MinIO, MongoDB, and GarageHQ examples with setup instructions

* docs: update README with dotenv docker setup instructions and configuration redirect for external services

* docker: update service dependency condition for setup-themes in docker-compose.yml

* chore: update example URLs in .env for public services
2026-07-29 09:07:52 +05:00

1.5 KiB

External MinIO

MinIO runs in a separate compose project. The Notesnook stack uses the root docker-compose.yml with notesnook.override.yml, which disables embedded notesnook-s3 / setup-s3 and points at external MinIO. Embedded MongoDB is unchanged.

Setup

From the repository root:

# Ensure MINIO_* in root .env match infra.env.example
# Merge notesnook delta if needed (see .env.example)

# 1. MinIO + bucket setup
docker compose -f examples/external-minio/infra.compose.yml \
  --env-file examples/external-minio/infra.env.example up -d

# Wait for notesnook-minio-setup to complete
docker compose -f examples/external-minio/infra.compose.yml ps -a

# 2. Notesnook
docker compose -f docker-compose.yml -f examples/external-minio/notesnook.override.yml up -d

Environment

File Purpose
infra.env.example MINIO_ROOT_USER / MINIO_ROOT_PASSWORD for infra stack
.env.example Notesnook delta (credentials must match infra)

Merge MINIO_* into root .env so the sync server uses the same credentials.

Stop

docker compose -f docker-compose.yml -f examples/external-minio/notesnook.override.yml down
docker compose -f examples/external-minio/infra.compose.yml down

Notes

  • Bucket attachments is created by notesnook-minio-setup on first infra start.
  • S3_INTERNAL_SERVICE_URL is overridden to http://notesnook-minio:9000.