{"id":2990,"date":"2024-06-24T10:17:11","date_gmt":"2023-12-16T10:01:57","guid":{"rendered":""},"modified":"2025-02-02T00:46:19","modified_gmt":"2025-02-01T23:46:19","slug":"how-to-install-gitlab-with-docker-on-ubuntu-22-04","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-gitlab-with-docker-on-ubuntu-22-04\/","title":{"rendered":"Linux VPS & VPS Windows Setup Guide | NetCloud24 GitLab with Docker on Ubuntu 22.04"},"content":{"rendered":"

\u00a0<\/p>\n<\/p>\n

\n

\u00a0<\/h1>\n<\/header>\n
\n

GitLab is a popular web-based DevOps lifecycle tool that provides a Git repository manager with CI\/CD pipeline features. In this tutorial, you will learn how to install GitLab using Docker on Ubuntu 22.04. Whether you are hosting it locally or on a , this guide will help you set up GitLab quickly and efficiently.<\/p>\n

\n

Step 1: Update Your System<\/h2>\n

Before starting the GitLab installation, ensure your Ubuntu system is up to date. Run the following commands to update the package list and upgrade installed packages:<\/p>\n

sudo apt update && sudo apt upgrade -y<\/code><\/pre>\n
Keeping your system updated is important, especially when deploying applications on platforms like VPS Windows VPS Servers<\/a>.<\/p>\n<\/section>\n
\n
Step 2: Install Docker and Docker Compose<\/h2>\n
GitLab will be deployed using Docker. First, you need to install Docker and Docker Compose:<\/p>\n
sudo apt install docker.io docker-compose -y<\/code><\/pre>\n
Start and enable the Docker service so that it starts automatically on boot:<\/p>\n
sudo systemctl start docker\r\nsudo systemctl enable docker<\/code><\/pre>\n<\/section>\n
\n
Step 3: Set Up GitLab Docker Container<\/h2>\n
Create a directory for your GitLab setup and navigate to it:<\/p>\n
mkdir ~\/gitlab-docker\r\ncd ~\/gitlab-docker<\/code><\/pre>\n
Create a docker-compose.yml<\/code> file with the following content:<\/p>\n
version: '3'\r\nservices:\r\n  web:\r\n    image: 'gitlab\/gitlab-ee:latest'\r\n    restart: always\r\n    hostname: 'gitlab.example.com'\r\n    environment:\r\n      GITLAB_OMNIBUS_CONFIG: |\r\n        external_url 'http:\/\/gitlab.example.com'\r\n    ports:\r\n      - '80:80'\r\n      - '443:443'\r\n      - '22:22'\r\n    volumes:\r\n      - '.\/config:\/etc\/gitlab'\r\n      - '.\/logs:\/var\/log\/gitlab'\r\n      - '.\/data:\/var\/opt\/gitlab'<\/code><\/pre>\n
Replace gitlab.example.com<\/code> with your domain name or server IP address.<\/p>\n<\/section>\n
\n
Step 4: Start the GitLab Container<\/h2>\n
After configuring the docker-compose.yml<\/code> file, run the following command to start the GitLab container:<\/p>\n
sudo docker-compose up -d<\/code><\/pre>\n
This command will download the necessary GitLab image, create the container, and run it in the background. You can check the status of the container using:<\/p>\n
sudo docker-compose ps<\/code><\/pre>\n
Once the container is up and running, you can access GitLab by navigating to http:\/\/your_domain_or_ip<\/code> in your web browser.<\/p>\n<\/section>\n
\n
Step 5: Configure GitLab<\/h2>\n
On first access, GitLab will prompt you to set a root password. After setting the password, you can log in using the username root<\/code> and the password you created.<\/p>\n
You can now start creating projects, repositories, and use GitLab\u2019s CI\/CD features.<\/p>\n<\/section>\n
\n
Step 6: Set Up SSL with Let\u2019s Encrypt (Optional)<\/h2>\n
To secure your GitLab instance with HTTPS, you can use Let\u2019s Encrypt. First, modify the docker-compose.yml<\/code> file to include SSL settings:<\/p>\n
version: '3'\r\nservices:\r\n  web:\r\n    image: 'gitlab\/gitlab-ee:latest'\r\n    restart: always\r\n    hostname: 'gitlab.example.com'\r\n    environment:\r\n      GITLAB_OMNIBUS_CONFIG: |\r\n        external_url 'https:\/\/gitlab.example.com'\r\n        letsencrypt['enable'] = true\r\n        letsencrypt['contact_emails'] = ['your_email@example.com']\r\n        letsencrypt['auto_renew'] = true\r\n    ports:\r\n      - '80:80'\r\n      - '443:443'\r\n      - '22:22'\r\n    volumes:\r\n      - '.\/config:\/etc\/gitlab'\r\n      - '.\/logs:\/var\/log\/gitlab'\r\n      - '.\/data:\/var\/opt\/gitlab'<\/code><\/pre>\n
Replace gitlab.example.com<\/code> with your domain and update the email address. After making the changes, restart the container:<\/p>\n
sudo docker-compose down\r\nsudo docker-compose up -d<\/code><\/pre>\n
Let\u2019s Encrypt will automatically generate and configure SSL certificates for your GitLab instance.<\/p>\n<\/section>\n