image when CI or another system already produces the container. Use an explicit version tag or immutable digest; latest is rejected. Towbar resolves tags to digests before execution and rejects a digest change during deployment.
Example manifest
This is the validated example from the Towbarexamples/platform-modes project. Replace the documentation IP, domain, and image choices with values for your environment.
.towbar/apps/image.app.yml
Configure it
The example uses an immutable nginx digest and setsbuildServer: null because no source build is needed. Match container.port and health.path to the image. A private image can reference an enabled OCI registry integration with deployment.registry.
A new image digest is a new deployment input. Pin the architecture with deployment.platform when the image or target requires it. Image rollback selects an earlier image; it does not reverse database migrations or persistent data changes.
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.