Documentation
How Towbar turns a repository manifest into deliberate deployments.
The model
A Source is a GitHub repository and branch. Synchronizing it imports Servers and Apps from .towbar/deployment.yml. The file is authoritative; Towbar keeps only operational state, history, encrypted credentials, and immutable deployment snapshots.
The safe path
Connect GitHub, add AWS credentials, add a Source, verify the first SSH host fingerprint, run a server check, and deploy an App. Webhooks only synchronize the Source.