Repository navigation
Release v0.1.4 - Master Key Authentication & Docker Improvements
🔒 Security & Authentication
Master Key Authentication (NEW)
- Auto-generate secure master keys for API authentication
- Support
LITELLM_MASTER_KEYenvironment variable for persistent keys - Display keys in
freerouter fetch,start, andstatuscommands - 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.ymlcompatibility 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_keyfiles will no longer be read - Users needing persistent keys should use
LITELLM_MASTER_KEYenv 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