Gitlab

Dokploy offer a way to connect your Gitlab Repository to your Dokploy panel, you can use Groups Names or personal accounts.

Go to Git and select Gitlab as the source, then you can use the following options:

• Application ID: Select the application ID that you want to connect to Dokploy.
• Personal Secret: Select the secret that you want to connect to Dokploy.
• Group Name(Optional): Select the group name that you want to connect to Dokploy(Ideal for Gitlab Groups).

Follow the steps to connect your Gitlab account to Dokploy.

1. Go to https://gitlab.com/-/profile/applications and click on Add New Application.
2. Set Application Name: eg. Dokploy-Gitlab-App. choose any name that you want.
3. Redirect URI: Copy the Redirect URI from Dokploy. eg. https://dokploy.com/api/providers/gitlab/callback.
4. Select Permissions: api, read_user, read_repository.
5. Click on Save Application.
6. Copy the Application ID and Secret from Gitlab and paste it in Dokploy Gitlab Modal section.
7. (Optional) If you want to use Groups, go to https://gitlab.com/dashboard/groups enter the group name you want to connect, and look at the URL in the address bar, it will be something like this https://gitlab.com/dokploy-panel/frontend you can use Nested Groups and SubGroups and copy the dokploy-panel/frontend from Gitlab and paste it in Dokploy Gitlab Modal section.
8. Click on Continue.
9. Go Back to Dokploy and click on Install button.
10. Click on Authorize.
11. You will be redirected to the Git section of Dokploy.
12. Now you can use the repositories from your Gitlab Account in Applications or Docker Compose services.

Setup Automatic Deployments

You can configure automatic deployments in Dokploy for the Following Services:

1. Applications
2. Docker Compose

The steps are the same for both services.

1. Go to either Applications or Docker Compose and go to Deployments Tab.
2. Copy the Webhook URL.
3. Go to your Gitlab Account and select the repository.
4. In the left menu, select Settings and then Webhooks.
5. Click on Add Webhook.
6. Set the URL to the one you copied in the previous step.
7. In the Trigger section, select Push Events.
8. Click on Add Webhook.
9. Click on Save.
10. Now you have automatic deployments enabled for the selected repository.

Clarification on Automatic Deployments

By default, Dokploy will automatically deploy your application on the Branch you have selected.

eg. Let's suppose you have a application in this way:

Repository: my-app Branch: feature

If you try to make a push on another branch eg. main, Dokploy will not automatically deploy your application, because your application have selected feature as the Branch.