Skip to content

Overview

Introduction

GitLab Community Edition (CE) is an open source end-to-end software development platform with built-in version control, issue tracking, code review, CI/CD, and more.

With GitLab packaged by Onteon Tech setup is easier and faster. The package adds additional security and runtime checks.

Installation does not require server connection to the Internet. All necessary components and dependencies, including Docker, are within the package.

Requirements

At least 10GB of free disk space and 4GB or RAM is required to run GitLab packaged by Onteon Tech.

Supported Operating Systems

GitLab packaged by Onteon Tech requires Ubuntu Linux versions 20.04 or 22.04.

If you need GitLab packaged by Onteon Tech for a different Linux distribution, contact us.

Installation

Before running installation switch to root (superuser) with the below sudo command: 

sudo su -l

To install run the install.bash script. The script is interactive and will ask following questions:

  • whether to install Docker --- answer "yes" or "no",
  • what IP address or hostname will be used for GitLab --- if the instance does not have a DNS name defined to be accessed with, you have to use the public IP address of the machine GitLab packaged by Onteon Tech is being installed into.
  • what port to use for GitLab's SSH service --- recommended port: "422",
  • where the service will be installed --- almost any system path could be used, but it is recommended to use either:
  • /opt/jlupin-managed/managed-gitlab-by-jlupin-platform
  • /srv/jlupin-managed/managed-gitlab-by-jlupin-platform
  • /var/lib/jlupin-managed/managed-gitlab-by-jlupin-platform

WARNING: Docker installation currently works only on Ubuntu version 20.04 and 22.04.

Post-installation

It will take some time for GitLab to initialize properly. You can monitor the GitLab bring-up progress via the command: docker logs --follow --tail=100 managed-gitlab-container

Administer GitLab with root account login as root with the password acquired by running the following command: docker exec -it managed-gitlab-container grep 'Password:' /etc/gitlab/initial_root_password

Use the password to log into the root account in the browser with the URL of IP address or hostname given in the second installation step, for example http://127.0.0.1/users/sign_in

Registry

After GitLab is finished installing and login works properly the service needs to be restarted to enable all GitLab registry features. When ready execute those command exactly:

systemctl stop managed-gitlab-by-jlupin-platform
systemctl start managed-gitlab-by-jlupin-platform

The GitLab instance will be restarted in up to 3 minutes. You can monitor the bringup with: docker logs --follow --tail=100 managed-gitlab-container.

Removal

Firstly run the remove.bash script, then delete the installation directory that was used in the installer. To prevent data loss remove.bash does not do that by default.