PHPackages amouhzi/pool-pilot - 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. amouhzi/pool-pilot ActiveProject[CLI & Console](/categories/cli) amouhzi/pool-pilot ================== A command-line tool to simplify the management of multiple PHP applications on a single server using PHP-FPM pools. v1.0.6(3mo ago)08MITPHPPHP >=8.2 Since Feb 1Pushed 3mo agoCompare [ Source](https://github.com/amouhzi/pool-pilot)[ Packagist](https://packagist.org/packages/amouhzi/pool-pilot)[ RSS](/packages/amouhzi-pool-pilot/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (7)Dependencies (5)Versions (8)Used By (0) PoolPilot ========= [](#poolpilot) PoolPilot is a command-line tool that simplifies infrastructure management for developers running multiple PHP applications on a single Debian/Ubuntu instance. Instead of maintaining a separate LXC container for every project, PoolPilot orchestrates a secure, shared environment using PHP-FPM pools. This tool automates the manual labor of system administration by handling: - **User Isolation**: Creates dedicated system users and groups for each application to enforce strict filesystem permissions. - **FPM Configuration**: Generates unique PHP-FPM pool configurations with dynamic socket allocation. - **Version Awareness**: Automatically detects the running PHP version (e.g., 8.2, 8.3) to apply the correct paths and service restarts. - **Service Management**: Seamless interaction with systemd to reload configurations instantly. Installation ------------ [](#installation) ### 1. Install PoolPilot [](#1-install-poolpilot) Install PoolPilot globally using Composer: ``` composer global require amouhzi/pool-pilot ``` ### 2. Update Your System PATH [](#2-update-your-system-path) To run the `pool-pilot` command from anywhere, you must add Composer's global `bin` directory to your system's `PATH`. First, find the correct directory by running: ``` composer global config bin-dir --absolute ``` Now, add the following line to your shell configuration file (e.g., `~/.bashrc`, `~/.zshrc`). Replace `~/.composer/vendor/bin` with the path you found above if it's different. ``` export PATH="$HOME/.composer/vendor/bin:$PATH" ``` Finally, reload your shell configuration to apply the changes: ``` source ~/.bashrc # Or for Zsh: # source ~/.zshrc ``` Updating -------- [](#updating) To update PoolPilot to the latest version, run: ``` composer global update amouhzi/pool-pilot ``` Usage ----- [](#usage) PoolPilot can be run in two modes: as the `root` user for simplicity, or as a non-root user for enhanced security. ### Simple Mode (As Root) [](#simple-mode-as-root) If you are logged in as `root`, you can run the command directly. The tool will handle all system operations without needing `sudo`. ``` pool-pilot app:create my-app my-app.com ``` ### Secure Mode (As a Non-Root User) [](#secure-mode-as-a-non-root-user) This is the recommended approach for production servers and automated deployments (e.g., with `php-deployer`). 1. **Create a Deployer User**: If you don't have one, create a dedicated user for deployments. 2. **Configure Sudo**: The tool will automatically use `sudo` for privileged operations. To allow this without a password, create a sudoers file for your deployer user: ``` sudo visudo -f /etc/sudoers.d/deployer ``` Add the following lines, which grant password-less access only to the commands PoolPilot needs: ``` # Allow the deployer user to manage users, services, and files for PoolPilot deployer ALL=(ALL) NOPASSWD: /usr/sbin/useradd, /usr/sbin/groupadd, /bin/systemctl, /bin/chown, /bin/chmod, /usr/bin/ln, /usr/bin/mkdir, /usr/bin/tee ``` 3. **Run the Command**: As the deployer user, run the command. `sudo` will be invoked automatically where needed. ``` pool-pilot app:create my-app my-app.com ``` Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a pull request. License ------- [](#license) This project is licensed under the MIT License. ### Health Score 38 — LowBetter than 85% of packages Maintenance82 Actively maintained with recent releases Popularity5 Limited adoption so far Community6 Small or concentrated contributor base Maturity51 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 ~0 days Total 7 Last Release 98d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/8da2a4376a9b330628e63e6d5b11ab407c17549b955b65adc19ca49b914e5fae?d=identicon)[amouhzi](/maintainers/amouhzi) --- Top Contributors [![amouhzi](https://avatars.githubusercontent.com/u/4458806?v=4)](https://github.com/amouhzi "amouhzi (13 commits)") ### Embed Badge ![Health badge](/badges/amouhzi-pool-pilot/health.svg) ``` [![Health](https://phpackages.com/badges/amouhzi-pool-pilot/health.svg)](https://phpackages.com/packages/amouhzi-pool-pilot) ``` ### Alternatives [symfony/maker-bundle Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code. 3.4k111.1M567](/packages/symfony-maker-bundle)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M650](/packages/sylius-sylius)[crunzphp/crunz Schedule your tasks right from the code. 2292.0M6](/packages/crunzphp-crunz)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu)[symplify/monorepo-builder Not only Composer tools to build a Monorepo. 5205.3M82](/packages/symplify-monorepo-builder) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)