Git Web Manager

Requirements

• PHP 8.2+ with required extensions.
• Composer 2.
• Node.js is optional and only needed for managed projects that run npm commands during deploys.
• 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.

Enterprise Package Dependency

The current application can include the Enterprise package in composer.json for premium and shared package functionality.

• Production should use a private Composer repository with credentials.
• Local development can use a Composer path repository that points at your local Enterprise package checkout.
• The Enterprise package ships its own static stylesheet from its package source, so deployed installs do not need Vite or a generated dist folder.

Docker Installation

Docker is optional, but provides the fastest way to get up and running.

Windows/macOS: install Docker Desktop.

Linux: install Docker Engine and the Docker Compose plugin.

docker version
docker compose version

Ensure the Docker engine is running before starting containers.

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.