Before you connect
- Configure the GitHub or GitLab integration and grant it access to the project.
- Register every target IP named by the manifest under Servers. A server can be prepared later, but it must exist before the first sync.
- Commit
towbar.ymland at least one entity file on the branch you plan to map. Start with the manifest guide.
towbar.yml
.towbar/apps/web.app.yml
id is its durable identity; name is a display label.
Connect in Towbar
Open Repositories → Add repository. Select the provider and project, choose the environments to import, and map each one to a branch. Towbar suggests environments from the default branch when it can read its configuration. You can add another environment name and map it to a branch that contains that environment intowbar.yml.
Review the first sync before deploying. A failed sync leaves existing inventory unchanged. Fix the files in Git and sync again; Towbar does not keep a second, editable copy of the workload definition.
Next: manage environment branches or prepare a server.