Gitlab

Nomploy offer a way to connect your Gitlab Repository to your Nomploy 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 Nomploy.
• Personal Secret: Select the secret that you want to connect to Nomploy.
• Group Name(Optional): Select the group name that you want to connect to Nomploy(Ideal for Gitlab Groups).

Follow the steps to connect your Gitlab account to Nomploy.

1. Go to https://gitlab.com/-/profile/applications and click on Add New Application.
2. Set Application Name: eg. Nomploy-Gitlab-App. choose any name that you want.
3. Redirect URI: Copy the Redirect URI from Nomploy. eg. https://nomploy.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 Nomploy 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/nomploy-panel/frontend you can use Nested Groups and SubGroups and copy the nomploy-panel/frontend from Gitlab and paste it in Nomploy Gitlab Modal section.
8. Click on Continue.
9. Go Back to Nomploy and click on Install button.
10. Click on Authorize.
11. You will be redirected to the Git section of Nomploy.
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 Nomploy 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, Nomploy 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, Nomploy will not automatically deploy your application, because your application have selected feature as the Branch.