Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  1. Deploy virtual server in Portal


    Skip this step if you already have a server. 

    If you need new server, you can deploy one via TDS portal - Orchestration - Servers#Howtodeploynewserver

  2. Install Docker engine on server – choose one of the following options
    • Option A - using "convenience script" from official instructions – recommended only for development and testing purposes

      Code Block
      curl -fsSL -o
      sudo sh
      sudo systemctl start docker

    • Option B - specific approach for each relevant OS - basically setting up repository and installing Docker Engine - all supported OS instructions can be found at
      • CentOS - official instructions

        Code Block
        sudo yum install -y yum-utils
        sudo yum-config-manager --add-repo
        sudo yum install docker-ce docker-ce-cli docker-buildx-plugin docker-compose-plugin -y

      • Fedora - official instructions

        Code Block
        sudo dnf -y install dnf-plugins-core
        sudo dnf config-manager --add-repo
        sudo dnf install docker-ce docker-ce-cli docker-buildx-plugin docker-compose-plugin -y

      • Ubuntu - official instructions

        Code Block
        sudo apt-get update
        sudo apt-get install ca-certificates curl gnupg lsb-release -y
        sudo mkdir -m 0755 -p /etc/apt/keyrings
        curl -fsSL | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
        echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

  3. Add your user to docker group to be able to run docker commands (more about security in article)

    Code Block
    sudo usermod -aG docker $USER

  4. Start docker container with latest version of gitlab runner (official instructions)

    Code Block
    docker run -d --name gitlab-runner --restart always -v /srv/gitlab-runner/config:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock gitlab/gitlab-runner:latest

  5. Configure GitLab runner to connect to your repository
    1. Go to desired GitLab repository → Settings → CI/CD → Runners
    2. Go to "Set up a specific runner for a project" section
      • Copy the "URL" and "registration token", you will need it in next steps
    3. Execute following command on the server with running docker container

      Code Block
      docker exec -it gitlab-runner gitlab-runner register --docker-privileged

    4. You will be prompted to fill-in following parameters:
      • URL from step 45.b.
      • Token from step 45.b.
      • Description
      • Tags for the runner (can leave this blank for the moment).
      • Specify docker executor
      • Specify a default Docker image (e.g. alpine:latest)