ChangeDetection.io - Towbar

Upstream source: Current installation guide. The /datastore volume holds watch definitions and history. The base installation checks ordinary pages; JavaScript-heavy sites may need a browser sidecar later.

Towbar manifest

.towbar/services/changedetection.service.yml

id: changedetection
name: ChangeDetection.io
buildServer: null
deployment:
  type: image
  image: ghcr.io/dgtlmoon/changedetection.io:0.50.14
container:
  port: 5000
  volumes:
    - name: datastore
      mountPath: /datastore
      initialData: image
environments:
  production:
    server: 192.0.2.10
rollout:
  type: recreate
  maintenanceMode: true
  reason: Persistent application data uses a single writer
domains:
  primary: changedetection.example.com
tls:
  mode: direct

Configure

Prepare the example server, connect the repository, and map production to the branch containing these manifests. Replace the example server IP and domain. Commit the manifests, then sync the repository and inspect the resolved configuration.
Keep the Service’s named volumes attached across deployments. Towbar’s Datastore backup policy does not back up Service volumes, so include them in your own recovery plan.
Deploy the Service, then perform the checks below before enabling auto-deploy.

Verify

Add a watch and confirm its history and configuration survive redeployment. For field constraints, see Service manifest.

Last modified on September 27, 2026