Skip to main content
Upstream source: Current installation guide. Gatus needs a versioned list of endpoints to check. The sample checks one public URL; it does not require a separate database for this first setup.

Towbar manifest

.towbar/services/gatus.compose.yml

Compose project

Configure

  1. Prepare the example server, connect the repository, and map production to the branch containing these files. Replace the example server IP and domain.
  2. Commit every file shown below under deploy/gatus/. The Towbar manifest points to the Compose file; it does not create it for you.
  3. Sync the repository and inspect the resolved Compose project. Save the runtime values below if this example declares any.
  4. Replace the example endpoint with a URL you control. Add alerting only after the basic check works; destination credentials belong in Towbar runtime secrets, not this file.
  5. Deploy it manually and run the verification below before enabling auto-deploy.

Verify

Open the status page, verify that the endpoint has a recent successful check, then temporarily use a failing URL to confirm the failure appears. For field constraints, see Compose guide.
Last modified on September 27, 2026