Skip to content
เอกสารคู่มือ

GitLab Installation

This content is not available in your language yet.

Install on a dedicated Linux instance via a single package (also known as Omnibus) that bundles all the different services and tools require to run GitLab.

Your can optionally read about Linux Package Installation on Gitlab Documentation.

Prerequisites

Section titled “Prerequisites”
  • 💿Persistence Storage.
    • Your Server Instance should have a disk and enough disk space.
  • 🛡️TLS Certificate
    • GitLab will be exposed through Web with HTTPS.
    • Will be guided in File Configuration section for TLS Certificate file placement.
  • Supported OS
    • Assume that Running Ubuntu 24.04 LTS
  • Chosen GitLab Edition
    • Assume that will be using GitLab Enterprise Edition gitlab-ee
    • For Community Edition replace gitlab-ee or -ee with gitlab-ce or -ce

Have Access to Linux Privileged Execution ; Usually root User or Access to sudo command.

As a basis of running a GitLab Instance,

Before You Go

Section titled “Before You Go”

You are about to perform on a Virtual Machine that play a role to be GitLab instance.

💡 Before proceed, Make sure you are connected to the GitLab Instance in any way possible, i.e SSH, Privileged Access Management Console, etc.

Installation

Section titled “Installation”

  1. Update your Host OS

    Terminal window
    sudo apt update
    sudo apt upgrade -y

  2. Install GitLab GPG Key, Repository of apt Package Manager

    Terminal window
    curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash

  3. Install GitLab Package (Specific GitLab Version)

    Visit GitLab Package Repository for browsing available version on repository.

    For Example, Installing 17.11.0

    Terminal window
    sudo apt install gitlab-ee=17.11.0-ee.0

Post Installation

Section titled “Post Installation”

  1. Hold GitLab Package Version with apt

    Terminal window
    sudo apt-mark hold gitlab-ee
    sudo apt-mark showhold # Show Hold Packages

  2. Run GitLab First-time Configuration

    Start and configure GitLab. Sometimes the first run fails, but after that, restarts fix problems, so ignore failures on this run.

    Terminal window
    sudo gitlab-ctl reconfigure creates=/var/opt/gitlab/bootstrapped
    ... (deducted)
    

    Notes:
    Default admin account has been configured with following details:
    Username: root
    Password: You didn't opt-in to print initial root password to STDOUT.
    Password stored to /etc/gitlab/initial_root_password. This file will be cleaned up in first reconfigure run after 24 hours.
    

    NOTE: Because these credentials might be present in your log files in plain text, it is highly recommended to reset the password following https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.
    

    gitlab Reconfigured!

  3. Gather root user password

    This will copy to your home folder of GitLab Host

    Terminal window
    sudo cp /etc/gitlab/initial_root_password ~/gitlab_initial_root_password

  4. Place Opstella Assets to GitLab Host

    Copy Opstella SVG Logo opstella-logo.svg from Assets folder to specific path of GitLab Directory and apply the appropriate file permission.

    You need to copy the file to the GitLab Host beforehand. (This is depends on how you can connect to the GitLab Instance.)

    • You can use scp to transfer file through SSH Connection.
    Terminal window
    sudo cp /CHANGEME/PATH/TO/opstella-logo.svg /opt/gitlab/embedded/service/gitlab-rails/public/assets/auth_buttons/opstella-logo.svg
    sudo chmod 644 /opt/gitlab/embedded/service/gitlab-rails/public/assets/auth_buttons/opstella-logo.svg

Finished?

Use the below navigation to proceed