Add Gitlab as a code provider

February 25, 2020

Before you can install your application code in the cloud, you need to set up an integration between Smoothy and your Git provider. This allows Smoothy to automatically download your code from Git, build it into an executable binary, and roll out the latest version of your application, whenever you push new code changes to your Git repository.

This tutorial walks you step-by-step through the process of setting up an integration between your Gitlab account and Smoothy.

The tutorial assumes that:

  1. You already have a Gitlab account

Add a Gitlab code provider #

To integrate a new code provider, you should head over to your team's integration page. This is accessible via the button in the right upper corner of Smoothy, as shown in the screenshot below.

Team navigation

Hover the button in the upper right corner of the code providers table and click Add code provider.

Code providers

Next, a modal will appear, similar to the one in the screenshot below. In this modal, you have to select which code provider that you like to set up an integration with. Given the focus of this tutorial, this should be Gitlab.

You also need to select who in your team will be able to use this code provider. You can choose between All team members and Only me.

When should you select which option?

  1. If your Gitlab account contains only repositories that are accessible to all your team members, you should select the option All team members. This enables all your colleagues to browse through your Git repositories and install the contents of any repository on a server.
  2. If your Gitlab account contains repositories that you don't want your colleagues to be able to deploy, you should select the option Only me. This way, your colleagues have no access to your Git repositories and only you can decide which Git repository to install on a server.

Finally, you can specify a name for your code provider. By default, Smoothy fills out this field for you so you can leave it untouched. However, if you have multiple Gitlab integrations, you can assign each of them a distinctive name.

Integrate Gitlab

In the next step of the process, you need to specify the URL of your Gitlab instance. If you use the hosted version of Gitlab, you can leave the URL untouched. However, if you use your own Gitlab installation, you need to alter the URL accordingly.

You also need to provide a Personal Access Token for your Gitlab account. To obtain such a token, you can follow along with the steps below.

Integrate Gitlab

First, head over to Gitlab. Hover the profile picture in the upper-right corner of the screen and click on Settings.

Integrate Gitlab

On the settings page of your Bitbucket account, click on the menu item Access Tokens in the navigation on the left-hand side of the page.

Integrate Gitlab

This page allows you to immediately create a new Personal Access Token for your account. In the form, you need to specify a name for your Personal Access Token. It is recommended to use the word Smoothy in the name so that you at a later point in time remember that this specific token was created to be used with Smoothy.

You should leave the expiration date for your token blank and, similar to the screenshot below, grant your token the api permissions.


This grants Smoothy full control over your public and private Gitlab repositories. This is necessary to be able to download the source code of your applications and automate your deployment processes.

Integrate Gitlab

As soon as you click Create personal access token, your new Personal Access Token will appear at the top of the page. Copy this token to your clipboard and head back to Smoothy.

Integrate Gitlab

Finally, paste the Personal Access Token in the respective field and hit Create.

Integrate Gitlab

Your new Gitlab integration should now appear on your team's integrations page.

Where to go from here? #

Now that you have set up an integration between your Gitlab account and Smoothy, you can turn the source code of your applications into an image. To do so, you can follow along with one of these tutorials.

Michiel Kempen

Michiel Kempen

A passionate cloud engineer who helps software companies adopt modern cloud technologies through an intelligent all-in-one cloud platform called Smoothy.