PHPackages seaman/seaman - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [CLI & Console](/categories/cli) 4. / 5. seaman/seaman ActiveProject[CLI & Console](/categories/cli) seaman/seaman ============= Docker development environment manager for Symfony 7+ v1.1.5(4mo ago)1201MITPHPPHP ^8.4CI passing Since Dec 3Pushed 4mo agoCompare [ Source](https://github.com/diego-ninja/seaman)[ Packagist](https://packagist.org/packages/seaman/seaman)[ RSS](/packages/seaman-seaman/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (8)Dependencies (18)Versions (9)Used By (1) [![Seaman logo](/assets/seaman-logo-github.png)](/assets/seaman-logo-github.png) Seaman ====== [](#seaman) **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. What does Seaman do? -------------------- [](#what-does-seaman-do) - **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:shell` instead of `docker-compose exec...` - **Toggles Xdebug** — Enable/disable without rebuilding containers - **Generates DevContainers** — VS Code integration out of the box Why not just write docker-compose.yml? -------------------------------------- [](#why-not-just-write-docker-composeyml) 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 Support ---------------- [](#platform-support) PlatformArchitectureStatusLinuxx86\_64TestedLinuxarm64TestedmacOSApple Silicon (M1/M2/M3)TestedmacOSIntelShould work (untested)WindowsWSL2Should work (untested)WindowsNativeNot supported**Requirements:** - Docker Engine or Docker Desktop - Docker Compose V2 60-Second Quickstart -------------------- [](#60-second-quickstart) ``` # 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:8000 ``` Installation ------------ [](#installation) ### Global (recommended) [](#global-recommended) ``` curl -sS https://raw.githubusercontent.com/diego-ninja/seaman/main/installer | bash ``` Installs to `/usr/local/bin` or `~/.local/bin`. ### As Composer dependency [](#as-composer-dependency) ``` composer require --dev seaman/seaman vendor/bin/seaman init ``` ### Verify installation [](#verify-installation) ``` seaman --version ``` Basic Usage ----------- [](#basic-usage) ``` seaman 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 service ``` Available Services ------------------ [](#available-services) **Databases:** 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) Documentation ------------- [](#documentation) Full documentation: [docs/](docs/index.md) - [Installation](docs/installation.md) - [Getting Started](docs/getting-started.md) - [Commands Reference](docs/commands.md) - [Services](docs/services.md) - [Configuration](docs/configuration.md) - [DevContainers](docs/devcontainers.md) Inspiration ----------- [](#inspiration) Seaman is inspired by [Laravel Sail](https://github.com/laravel/sail) and [DDEV](https://github.com/ddev/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. License ------- [](#license) MIT License. See [LICENSE](LICENSE). Credits ------- [](#credits) Developed by [Diego Rin](https://diego.ninja). - [Report bugs](https://github.com/diego-ninja/seaman/issues) - [Request features](https://github.com/diego-ninja/seaman/issues) - [Contribute](docs/development.md) ### Health Score 39 — LowBetter than 86% of packages Maintenance74 Regular maintenance activity Popularity7 Limited adoption so far Community8 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Total 8 Last Release 142d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/dff5b0a76de3d555cb236c400384058ba23982bce2e859cc1b2f0c1f0161a3e6?d=identicon)[diego.ninja](/maintainers/diego.ninja) --- Top Contributors [![diego-ninja](https://avatars.githubusercontent.com/u/78662279?v=4)](https://github.com/diego-ninja "diego-ninja (339 commits)") --- Tags clidevelopment-environmentdockerphp8symfony ### Code Quality TestsPest Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/seaman-seaman/health.svg) ``` [![Health](https://phpackages.com/badges/seaman-seaman/health.svg)](https://phpackages.com/packages/seaman-seaman) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.6k509.9M17.0k](/packages/laravel-framework)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[matomo/matomo Matomo is the leading Free/Libre open analytics platform 21.4k37.3k](/packages/matomo-matomo)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[laravel-zero/framework The Laravel Zero Framework. 3371.4M369](/packages/laravel-zero-framework)[illuminate/console The Illuminate Console package. 12944.1M5.1k](/packages/illuminate-console) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)