Gitlab

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

Follow the steps to connect your Gitlab account to Notploy.

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