Skip to content

Deploy with Docker Compose

Use Docker Compose for quick local or validation deployments.

Prebuilt images

git clone https://github.com/ksperis/s3-manager.git
cd s3-manager
S3_MANAGER_TAG=latest docker compose up

Build from source

From repository root:

docker compose -f docker-compose.build.yml up --build

Default endpoints

  • Frontend: http://localhost:8080
  • API base: http://localhost:8000/api
  • OpenAPI: http://localhost:8000/docs

Scheduler service

The compose stack includes a scheduler container that triggers:

  • endpoint healthchecks (default every 5 minutes)
  • billing daily collection (default 02:00 UTC, day offset 1)
  • quota monitoring (default every hour)

Set a strong shared token in .env:

INTERNAL_CRON_TOKEN=change-me-strong

Main scheduler knobs:

  • HEALTHCHECK_CRON_SCHEDULE
  • BILLING_CRON_SCHEDULE
  • QUOTA_MONITOR_CRON_SCHEDULE
  • BILLING_DAY_OFFSET

History retention / SMTP knobs:

  • BILLING_DAILY_RETENTION_DAYS
  • QUOTA_HISTORY_HOURLY_RETENTION_DAYS
  • QUOTA_HISTORY_DAILY_RETENTION_DAYS
  • SMTP_PASSWORD