Git Web Manager

Health Check URL

The Health Check URL is used to monitor availability. Provide a full URL or a path relative to the project base.

If the Health Check URL is left blank, GWM will check the project’s Site URL instead (Laravel defaults to /up).

Laravel 11 ships with /up as a built-in health endpoint. It’s a great default for Laravel apps, but any endpoint returning 200 OK can be used.

Monitoring Eligibility

A project must have at least one of the following configured to participate in health monitoring:

• Health Check URL — a dedicated endpoint to poll.
• Site URL — used as the fallback target when no health URL is set.

If both fields are empty, the project is excluded from health monitoring entirely. This means:

• No health check jobs are scheduled for the project.
• No Health: N/A badge appears on the project card.
• The project does not appear in the Health Problems panel on the Dashboard or the project list.

Projects used purely for deployments without a public URL (for example internal tooling or non-web projects) will no longer generate spurious health alerts after both URL fields are left blank.

Laravel Health Check

For Laravel projects, GWM runs a quick filesystem check before the HTTP request.

• Ensures storage/framework/cache/data, bootstrap/cache, and storage/app/public exist and are writable.
• Verifies public/storage is a symlink to storage/app/public (and attempts to create it if missing).
• Ensures .htaccess exists in the project root and public/.htaccess exists for Apache rewrite rules.

If these checks fail, the health status is marked as not available and the reason appears on the project overview screen.

Refresh Timing

Health status refreshes every minute on the projects list and on project detail views. Manual refresh is also available.

Deploy Guardrails

If a deploy fails and the health status changes from OK to failing, GWM automatically attempts a rollback to the last known-good deployment.