Requirements
- PHP 8.2+ with required extensions.
- Composer 2.
- Node.js 18+ (20/22/24 recommended) for Vite builds.
- Git CLI accessible to the web user.
- PHP-FPM pool runs as the same user who owns the deployment paths.
- Queue worker for webhook deploys.
Recommended Layout
Install GWM on the same host where your websites live so it can deploy directly to local paths. If a path does not exist, GWM can create it.
Queue Worker
Webhook-driven deploys and background tasks use the queue system:
php artisan queue:work
Git Web Manager is built on Laravel, so queue commands use artisan. If you run GWM under a custom PHP binary, prefix the command with your PHP path.
