Files
Charon/.docker/compose
GitHub Actions 999e622113 feat: Add emergency token rotation runbook and automation script
- Created a comprehensive runbook for emergency token rotation, detailing when to rotate, prerequisites, and step-by-step procedures.
- Included methods for generating secure tokens, updating configurations, and verifying new tokens.
- Added an automation script for token rotation to streamline the process.
- Implemented compliance checklist and troubleshooting sections for better guidance.

test: Implement E2E tests for emergency server and token functionality

- Added tests for the emergency server to ensure it operates independently of the main application.
- Verified that the emergency server can bypass security controls and reset security settings.
- Implemented tests for emergency token validation, rate limiting, and audit logging.
- Documented expected behaviors for emergency access and security enforcement.

refactor: Introduce security test fixtures for better test management

- Created a fixtures file to manage security-related test data and functions.
- Included helper functions for enabling/disabling security modules and testing emergency access.
- Improved test readability and maintainability by centralizing common logic.

test: Enhance emergency token tests for robustness and coverage

- Expanded tests to cover various scenarios including token validation, rate limiting, and idempotency.
- Ensured that emergency token functionality adheres to security best practices.
- Documented expected behaviors and outcomes for clarity in test results.
2026-01-26 06:27:57 +00:00
..

Docker Compose Files

This directory contains all Docker Compose configuration variants for Charon.

File Descriptions

File Purpose
docker-compose.yml Main production compose configuration. Base services and production settings.
docker-compose.dev.yml Development overrides. Enables hot-reload, debug logging, and development tools.
docker-compose.local.yml Local development configuration. Standalone setup for local testing.
docker-compose.remote.yml Remote deployment configuration. Settings for deploying to remote servers.
docker-compose.override.yml Personal local overrides. Gitignored - use for machine-specific settings.

Usage Patterns

Production Deployment

docker compose -f .docker/compose/docker-compose.yml up -d

Development Mode

docker compose -f .docker/compose/docker-compose.yml \
               -f .docker/compose/docker-compose.dev.yml up -d

Local Testing

docker compose -f .docker/compose/docker-compose.local.yml up -d

With Personal Overrides

Create your own docker-compose.override.yml in this directory for personal configurations (port mappings, volume paths, etc.). This file is gitignored.

docker compose -f .docker/compose/docker-compose.yml \
               -f .docker/compose/docker-compose.override.yml up -d

Notes

  • Always use the -f flag to specify compose file paths from the project root
  • The override file is automatically ignored by git - do not commit personal settings
  • See project tasks in VS Code for convenient pre-configured commands