Disabling Companion Git Repositories

Companion Git Repositories are a legacy feature on Aptible Deploy.

We have to keep them around for backwards compatibility, but as a user, you might wish to avoid using them altogether, even accidentally.

To do so, on dedicated stacks, you can contact Aptible Support to have us disable this feature for you.

When Companion Git Repositories are disabled, your deploys must use either Direct Docker Image Deploy or Dockerfile Deploy (i.e. deploy via Git push). Attempts to perform mixed-mode deployment using Companion Git Repositories will raise an error.


If you’d like to go down this route, first make sure that you are not using Companion Git Repositories in your deployments.

There is a warning when you deploy that will inform you if that is the case, so look for that. The warning mentions “Deploying with a Companion Git Repository is deprecated”.

If you find an app currently using a Companion Git Repository, you’ll need to get rid of it. To do so, follow the instructions in Migrating from Dockerfile Deploy.

Once all your apps have been migrated, contact Aptible Support.