Docker development environments for Symfony, without the boilerplate.
Seaman generates and manages Docker Compose configurations for Symfony projects. Instead of writing docker-compose.yml, Dockerfiles, and environment files from scratch, you run seaman init and get a working development environment in under a minute.
- Generates Docker configuration — Creates docker-compose.yml, Dockerfile, and .env tailored to your Symfony project
- Manages services — Add/remove databases, caches, queues, and dev tools with simple commands
- Handles the tedious parts — Healthchecks, networking, volume persistence, port conflicts
- Provides shortcuts —
seaman console,seaman composer,seaman db:shellinstead ofdocker-compose exec... - Toggles Xdebug — Enable/disable without rebuilding containers
- Generates DevContainers — VS Code integration out of the box
You can. Seaman generates standard Docker Compose files you can inspect, modify, or replace.
Seaman is useful when you want:
- Fast onboarding — New team members run two commands instead of reading setup docs
- Consistent defaults — Same PHP config, healthchecks, and networking across projects
- Less maintenance — Update Seaman, regenerate configs, done
- Interactive setup — Choose services from a menu instead of copy-pasting YAML
Tradeoffs:
- Less flexibility than hand-written configs
- Another tool to learn
- Opinionated structure (
.seaman/directory, generated files)
| Platform | Architecture | Status |
|---|---|---|
| Linux | x86_64 | Tested |
| Linux | arm64 | Tested |
| macOS | Apple Silicon (M1/M2/M3) | Tested |
| macOS | Intel | Should work (untested) |
| Windows | WSL2 | Should work (untested) |
| Windows | Native | Not supported |
Requirements:
- Docker Engine or Docker Desktop
- Docker Compose V2
# Install Seaman
curl -sS https://raw.githubusercontent.com/diego-ninja/seaman/main/installer | bash
# Initialize your project (or create new one)
cd your-symfony-project
seaman init
# Start the environment
seaman start
# Your app is running at http://localhost:8000curl -sS https://raw.githubusercontent.com/diego-ninja/seaman/main/installer | bashInstalls to /usr/local/bin or ~/.local/bin.
composer require --dev seaman/seaman
vendor/bin/seaman initseaman --versionseaman init # Interactive setup
seaman start # Start all services
seaman stop # Stop all services
seaman status # Show service status
seaman console cache:clear # Run Symfony console
seaman composer require foo/bar # Run Composer
seaman db:shell # Database CLI
seaman xdebug on # Enable Xdebug
seaman xdebug off # Disable Xdebug
seaman service:add # Add a service
seaman service:remove # Remove a serviceDatabases: PostgreSQL, MySQL, MariaDB, MongoDB, SQLite
Cache: Redis, Valkey, Memcached
Queues: RabbitMQ, Kafka
Search: Elasticsearch, OpenSearch
Dev Tools: Mailpit (email testing), Minio (S3-compatible storage), Dozzle (log viewer)
Proxy: Traefik (reverse proxy with automatic HTTPS)
Full documentation: docs/
Seaman is inspired by Laravel Sail and DDEV. Sail provides similar functionality for Laravel projects, while DDEV is a comprehensive local development environment for PHP projects. If you've used either, Seaman will feel familiar. If you haven't, don't worry — Seaman is standalone and doesn't require any prior knowledge of these tools.
MIT License. See LICENSE.
Developed by Diego Rin.