Skip to content

Release v0.1.4 - Master Key Authentication & Docker Improvements

Choose a tag to compare

@mmdsnb mmdsnb released this 28 Dec 05:26
· 3 commits to master since this release

🔒 Security & Authentication

Master Key Authentication (NEW)

  • Auto-generate secure master keys for API authentication
  • Support LITELLM_MASTER_KEY environment variable for persistent keys
  • Display keys in freerouter fetch, start, and status commands
  • Ephemeral key mode by default (regenerates on each fetch)
  • Complete test coverage with 4 passing tests

🐳 Docker Improvements

Docker Deployment

  • Reorganized all Docker files into docker/ directory
  • Fixed container restart loops with proper entrypoint
  • Improved docker-compose.yml compatibility with 1Panel and strict parsers
  • Multi-platform images (amd64, arm64) via GitHub Actions
  • Images published to ghcr.io/mmdsnb/freerouter

Usage:

docker pull ghcr.io/mmdsnb/freerouter:latest
docker-compose -f docker/docker-compose.yml up -d

📦 What's Changed

  • feat(security): add master_key authentication support (#770ce51, #8349101)
  • feat(cli): display master_key in status command (#4f18d1d)
  • refactor(security): simplify to ephemeral-only design (#770ce51)
  • refactor(docker): organize files into docker/ directory (#b8fc060)
  • fix(docker): container lifecycle improvements (#252cf4c, #03f9846)
  • fix(docker): improve docker-compose.yml compatibility (#85039b4)
  • security(gitignore): prevent secret leakage (#5cbce61)

🔧 Breaking Changes

  • Existing .master_key files will no longer be read
  • Users needing persistent keys should use LITELLM_MASTER_KEY env var

📊 Test Coverage

  • Master key generation: ✅ 4/4 tests passing
  • Integration tests: 3/3 tests (marked as optional)

Full Changelog: v0.1.3...v0.1.4