Skip to main content
Choose a Compose workload when several services must be deployed as one project. Place its entity under .towbar/compose and point file and optional overrides at Compose files in the same immutable checkout.

​
Example manifest

This is the validated example from the Towbar examples/platform-modes project. Replace the documentation IP, domain, and image choices with values for your environment.
.towbar/compose/storefront.compose.yml

​
Configure it

The example gives the web service a public proxy route and keeps cache internal. Towbar validates the resolved Compose project before Docker opens it. Compose builds run on the runtime server because the service graph is resolved as one project. Remote includes, privileged containers, Docker socket mounts, host bind mounts, devices, public host ports, and external or explicitly named Docker resources are rejected. Compose replacement uses recreate or maintenance; rolling replacement is not supported. Map the named environment to a branch, register and prepare its server, then sync the repository. Start with a manual deployment and verify the running service before opting into automation. See Application manifest for shared fields and Deployment modes to compare modes.
Last modified on September 26, 2026