Connect source code

Git-based applications need a repository URL, branch, and authentication method that Coolify can use from the deployment path.

The short version

Use HTTPS for a public repository, an SSH deploy key for one private repository, or a GitHub App for scoped repository access with integrated webhooks.

Choose a source method

Method	When to use it	Guide
Public repository	The repository is public and can be cloned over HTTPS without credentials.	Connect a public repository
Deploy key	One private repository needs read-only SSH access.	Use a deploy key
GitHub App	GitHub repositories need scoped access, integrated webhooks, and pull-request events.	Configure a GitHub App

Official Git App integrations configure provider webhooks as part of the source. Public repositories and deploy keys require manual webhooks for automatic deployments and previews.

Repository access and container registries are separate

Git credentials let Coolify clone source code. Registry credentials let Docker pull or push images.

A deploy key cannot authenticate to a private container registry. Read Docker registries when the application uses a private image or pushes a built image.

Choose the next source guide

Connect a public repository

Deploy source that can be cloned over HTTPS without credentials.

Use a deploy key

Grant read-only SSH access to one private repository.

Connect GitHub

Choose a public repository, deploy key, or GitHub App connection.