docker-compose-dev

matt-riley's avatarfrom matt-riley

Run mjr.wtf locally using Docker Compose (SQLite), including migrations, logs, and teardown.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026⬇️1downloads
[Developer Tools]

When & Why to Use This Skill

This Claude skill automates the local deployment and lifecycle management of the mjr.wtf project using Docker Compose and SQLite. It simplifies complex setup tasks including environment configuration, automated database migrations, health monitoring, and resource teardown, providing a seamless 'one-command' experience for developers.

Use Cases

  • Rapid Local Development: Quickly spin up the mjr.wtf environment with all dependencies and SQLite configurations pre-set, reducing manual setup time.
  • Automated Database Migrations: Ensure the local database schema is always current by automatically running migrations during the container startup process.
  • Service Health and Log Monitoring: Efficiently verify system readiness and troubleshoot issues using integrated health check commands and log streaming.
  • Clean Environment Management: Perform standardized teardowns and resource cleanup to maintain a clutter-free local development workspace.
namedocker-compose-dev
descriptionRun mjr.wtf locally using Docker Compose (SQLite), including migrations, logs, and teardown.
licenseMIT
compatibilityRequires docker, docker compose, bash, git, and make.
repomjrwtf
runnergithub-copilot-cli
version1.1
allowed-toolsBash(git:*) Bash(make:*) Bash(docker:*) Bash(curl:*) Read

Quick start (SQLite via compose)

  1. Create env file:
cp .env.example .env
# set AUTH_TOKENS (preferred) or AUTH_TOKEN
  1. Create the persistent data directory:
mkdir -p data
  1. Start services (Docker Compose runs migrations automatically on startup via docker-entrypoint.sh):
make docker-compose-up
  1. Verify health:
curl http://localhost:8080/health
curl http://localhost:8080/ready

Useful ops

make docker-compose-logs
make docker-compose-ps
make docker-compose-down