Rails 8 Dev Stack

Rails 8 Dev Stack

A production-ready Docker Compose development environment for Rails 8. Clone the repo, run one command, and you are coding — no manual configuration required.

What's Included

• Rails 8.1 — Latest Rails with Hotwire, Turbo, and Stimulus configured out of the box
• PostgreSQL 16 — Primary database with a named persistent volume
• Redis 7 — Backs Action Cable, Rails cache store, and Sidekiq
• Sidekiq 7 — Background job processing with web UI mounted at /sidekiq
• Mailpit — Local SMTP server that catches all outgoing email; inspect it at port 8025
• pgAdmin 4 — Full-featured Postgres GUI at port 5050

Developer Experience

• Hot reload via Bootsnap + Rails reloader — file changes reflect in the browser without restarting the container
• Pre-configured database.yml, cable.yml, and sidekiq.yml
• App directory bind-mounted so all edits are live immediately
• Health checks on Postgres and Redis — Rails waits until both are ready before starting
• Single docker compose up starts the entire stack

What You Get

• docker-compose.yml — fully configured multi-service stack
• Dockerfile — lean Ruby 3.4 Alpine development image
• Gemfile with Rails 8.1, Sidekiq, Tailwind CSS, and dev/test gems
• .env.example with every variable documented
• README.md — quickstart guide, service URLs, and common tips

Service URLs

Requirements

Docker Desktop or Docker Engine with the Compose plugin. No local Ruby, Postgres, or Redis installation needed.