Coolify v3 (deprecated)
Sources
Git Sources
Git Sources defines where to fetch/pull your application code.
These sources are used to:
- Setup helper apps (such as GitHub App, GitLab App) at your Git providers.
- Provides access through tokens/ssh keys to your repositories.
- Clone your application’s code.
- Set up webhooks for automated deployments.
Supported Git Sources
- GitHub
- GitLab
You can use self-hosted or enterprise version of these Git providers as well.
How to Integrate with Gitlab
- (in Coolify) If you haven’t already, in Settings, specify a URL (FQDN) like
coolify.yourdomain.com
. This is not required, but it makes the setup easier. - Once that’s complete, close the page, navigate to
coolify.yourdomain.com
, and log back in. - (in Coolify) In
Git Sources
, add a new GitLab source. - In a new browser tab, navigate to your GitLab instance and find the UI to add a new application.
- (in GitLab) Enter the
Callback URL
ashttps://coolify.yourdomain.com/webhooks/gitlab
. - (in GitLab) check the following scopes:
api
,read_repository
,email
. - (in GitLab) Save the application and copy the
Application ID
. - (in Coolify) In your new source, paste the
Application ID
. - (in GitLab) In the newly created application, copy the
Secret
. - (in Coolify) Paste the
Secret
. - (in Coolify) Enter the OAuth ID. It will be the located at the end of the url of your GitLab application:
https://yourgitlabdomain.com/oauth/applications/123456
. - (in Coolify) Hit save.
- (in Coolify) In
Applications
add a new application with GitLab as the source. - If you’re still logged into GitLab, an authorization popup will appear. Click authorize.
Import Public Git Repositories
You can import any public git repositories from Github or Gitlab with a simple URL
Examples GitHub:
- https://github.com/coollabsio/coolify-examples -> You can select the branch afterwards.
- https://github.com/coollabsio/coolify-examples/tree/static -> Preselect
static
branch.
Example GitLab:
- https://gitlab.com/aleveha/fastify-example -> You can select the branch afterwards.
- https://gitlab.com/aleveha/fastify-example/-/tree/master -> Preselect
main
branch.