Satifly is the easiest and fastest way to host and manage your private Composer packages. Built for modern PHP developers, it combines the power of Satis with the performance of FrankenPHP and the reliability of Caddy — all wrapped in a clean, production-ready Docker environment.
Managing private Composer packages doesn’t have to be painful. Satifly eliminates manual configuration, provides a beautiful web UI, and automates your build and deployment process — securely and efficiently.
- 🌐 Full-featured web dashboard — manage
satis.jsonvisually - 🔐 Authentication — protect your internal registry with ease
- ⚡ FrankenPHP-powered performance — fast, concurrent builds out of the box
- 🐳 Zero-effort Docker stack — ready to run in seconds
- 🔄 VCS webhooks — automatic package rebuilds on push
- 🚀 HTTP/3 + Early Hints — next-gen web delivery built-in
Satifly builds upon the excellent work of project-satisfy/satisfy, extending it with cutting-edge tooling and developer-first improvements.
- Install Docker Compose (v2.10+)
- Clone and enter the repository:
git clone https://github.com/Trusted97/satifly
cd satifly
- Build and launch Satifly:
make build
make up
make doctor
- Open https://localhost and enjoy your private PHP registry.
- Stop everything when you’re done:
make down
👉 Want advanced Docker, Composer, or Xdebug workflows? Refer to the Makefile documentation for advanced commands.
Use your existing satis.json or generate one instantly:
make satis-init
Prefer a visual experience? Configure everything directly via the web UI at /admin/configuration.
📚 For more details on how Satis works (configuration examples, usage, and authentication), refer to the official Composer documentation: Using Satis
Tune Satifly’s behavior in app/config/parameters.yml.
Example: enable admin authentication
admin:
auth: true
users:
- { username: admin, password: secret }Not a Docker fan? Install manually with Composer:
git clone https://github.com/Trusted97/satisfy
wget http://getcomposer.org/composer.phar
php composer.phar install -n
Your Satifly instance serves the web UI from the public directory. Access /admin to manage repositories and configuration.
Build package definitions anytime with:
make satis-build
- ✅ Production-grade by design — secure, scalable, and battle-tested
- 🐘 Built with Symfony 7.4 & PHP 8.4 — modern, reliable foundation
- 🚀 FrankenPHP worker mode — ultra-fast and memory efficient
- 🔒 Automatic HTTPS with Caddy
- 🧩 Extensible architecture — customize for your organization
- 👨💻 Dev, CI, and production ready out of the box
Satifly is open source and distributed under the MIT License. For details, see the LICENSE file.
We welcome contributions from developers and organizations! Whether it’s improving documentation, adding integrations, or refining the UI, your input helps Satifly grow.
Fork the project on GitHub, open a pull request, and join the mission to simplify PHP package management.