GitLab op een Linux-server installeren – Host je eigen DevOps-platform

Ontdek hoe je GitLab efficiënt op Linux installeert om DevOps-workflows te optimaliseren en samenwerking in teams te verbeteren → Lees nu meer

10 november 20266 min leestijd0 Weergaven0 nuttig

Inleiding

GitLab is een uitgebreide DevOps-platform waarmee teams samen aan code kunnen werken, workflows kunnen automatiseren en de volledige softwareontwikkelingscyclus efficiënt kunnen beheren. In deze handleiding leggen we uit hoe je GitLab op een Linux-server installeert.

GitLab installeren met One-Click Apps

Je kunt GitLab direct via One-Click Apps in het VPS-webinterface installeren. Na de eerste setup van de apps open je de app-catalogus, zoek je naar GitLab en start je de installatie met je favoriete project-, omgeving- en domeininstellingen. Zo kun je GitLab snel en gebruiksvriendelijk uitrollen en beheren, zonder handmatige commandoregelinstallaties, en profiteer je toch van geïntegreerd webbeheer, ondersteuning voor eigen domeinen en SSL-uitgifte waar beschikbaar.

Voorbereiding

De volgende vereisten worden aanbevolen door het officiële GitLab Team. Het is sterk aan te raden om aan deze voorwaarden te voldoen om latere problemen en ongemakken te voorkomen.

Hardware

Componenten	Minimum	Aanbevolen
CPU	2x 2 GHz	4x 2,6+ GHz
RAM	4 GB	8 GB
Opslag	10 GB	50+ GB
Bandbreedte	100 Mbit/s (Up & Down)	100 Mbit/s (Up & Down)

Software

Platform	Opties
Besturingssysteem	Ubuntu (20.04, 22.04, 24.04), Debian (10, 11, 12), OpenSUSE (15.5)
Database	PostgreSQL 14.9+
Webserver	NGINX (meegeleverd met GitLab), Puma 6.4.2+
Overig	Redis 7.x+, Sidekiq 7.3.2+, Prometheus 2.54.1+

Info

Voor de meest actuele en nauwkeurige specificaties, raadpleeg de officiële Hardware Requirements documentatie van GitLab.

Om GitLab op je Linux-server te installeren, moet je verbinding maken via een SSH-client. Bekijk hiervoor onze Eerste toegang (SSH) handleiding.

Zodra de verbinding staat, kun je de benodigde pakketten installeren die voor de GitLab-installatie vereist zijn.

Stap 1: Afhankelijkheden installeren

Je moet eerst enkele afhankelijkheden installeren zodat de GitLab-installatie kan draaien. Gebruik de volgende commando's om de benodigde pakketten op je Linux-server te installeren.

Werk de pakketlijst bij en installeer de OpenSSH-server en de vereiste afhankelijkheden met het volgende commando. Zo wordt je webinterface voor GitLab gehost.

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates tzdata perl

Optioneel kun je Postfix (SMTP-server) installeren als je e-mailmeldingen via GitLab wilt versturen.

Als je e-mailmeldingen wilt gebruiken, installeer dan Postfix met:

Code

sudo apt-get install -y postfix

Werk de pakketlijst bij en installeer de OpenSSH-server en de vereiste afhankelijkheden met het volgende commando. Zo wordt je webinterface voor GitLab gehost.

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates perl

Optioneel kun je Postfix (SMTP-server) installeren als je e-mailmeldingen via GitLab wilt versturen.

Als je e-mailmeldingen wilt gebruiken, installeer dan Postfix met:

Code

sudo apt-get install -y postfix

Installeer de OpenSSH-server en de vereiste afhankelijkheden met het volgende commando. Zo wordt je webinterface voor GitLab gehost.

Code

sudo zypper install curl openssh perl

Zorg ervoor dat de OpenSSH-daemon is ingeschakeld:

Code

sudo systemctl status sshd
sudo systemctl enable sshd
sudo systemctl start sshd

Als je firewalld gebruikt, zorg dan dat de benodigde poorten openstaan.

Controleer of firewalld actief is met:

bash

sudo systemctl status firewalld

Als dat zo is, open dan de standaardpoorten (80 en 443):

Code

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld

Optioneel kun je Postfix (SMTP-server) installeren als je e-mailmeldingen via GitLab wilt versturen.

Als je e-mailmeldingen wilt gebruiken, installeer dan Postfix met:

Code

sudo zypper install postfix
sudo systemctl enable postfix
sudo systemctl start postfix

Info

Tijdens de installatie van Postfix kan een configuratiescherm verschijnen. Kies hier "Internet Site" en bevestig met Enter. Voer als "mail name" de externe DNS van je Linux-server in en bevestig. Als er meer schermen verschijnen, bevestig dan telkens met Enter om de standaardwaarden te accepteren. Als je een andere oplossing voor e-mailverzending wilt gebruiken, sla deze stap dan over en configureer een externe SMTP-server na de GitLab-installatie volgens de officiële handleiding.

Stap 2: GitLab installeren

Nadat alle afhankelijkheden zijn geïnstalleerd, kun je GitLab installeren.

In deze handleiding installeren we GitLab rechtstreeks vanuit de officiële pakketrepositories.

Het volgende script voegt de GitLab-repositories toe aan de apt-pakketbeheerder:

Code

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

Daarna kun je het pakket gitlab-ee installeren:

bash

sudo apt-get install -y gitlab-ee

Het volgende script voegt de GitLab-repositories toe aan de Zypper-pakketbeheerder:

Code

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash

Daarna kun je het pakket gitlab-ee installeren:

bash

sudo zypper install gitlab-ee

Na voltooiing van dit proces zou GitLab klaar voor gebruik moeten zijn op je Linux-server. In het volgende gedeelte configureer je belangrijke instellingen zodat de server soepel draait.

Stap 3: GitLab configureren

Om alles te laten werken, moet je enkele aanpassingen doen in het configuratiebestand. Open het GitLab-configuratiebestand met je favoriete teksteditor. We gebruiken hier als voorbeeld de vooraf geïnstalleerde nano editor.

Code

sudo nano /etc/gitlab/gitlab.rb

Zoek de regel external_url en vul daar je domein of het IP-adres van je Linux-server in, als je geen domein voor GitLab wilt gebruiken.

Code

## GitLab URL
##! URL waarop GitLab bereikbaar zal zijn.
##! Voor meer details over het configureren van external_url zie:
##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab
##!
##! Opmerking: Tijdens installatie/updates wordt de waarde van de omgevingsvariabele
##! EXTERNAL_URL gebruikt om deze waarde in te stellen/te vervangen.
##! Bij AWS EC2-instanties wordt geprobeerd de publieke hostnaam/IP
##! van AWS op te halen. Meer info:
##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html
external_url 'http`s`://`Jouw domein / IPv4-adres van je Linux-server`'

We raden ook aan je e-mailadres in te vullen bij de regel letsencrypt['contact_emails']. Zo kan Let's Encrypt je informeren en contacteren over automatische en gratis SSL-certificaten.

Info

Voor een gratis SSL-certificaat van Let's Encrypt heb je een domein nodig. Een certificaat direct voor een IP-adres kun je niet aanvragen.

Code

################################################################################
# Let's Encrypt Integratie
################################################################################
# letsencrypt['enable'] = nil
# letsencrypt['contact_emails'] = [`Jouw e-mail hier`] # Dit moet een array van e-mailadressen zijn
# letsencrypt['group'] = 'root'
# letsencrypt['key_size'] = 2048
# letsencrypt['owner'] = 'root'
# letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www'
# Zie https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically voor meer info
# letsencrypt['auto_renew'] = true
# letsencrypt['auto_renew_hour'] = 0
# letsencrypt['auto_renew_minute'] = nil # Moet een getal of cron-expressie zijn, indien opgegeven.
# letsencrypt['auto_renew_day_of_month'] = "*/4"
# letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt'
# letsencrypt['alt_names'] = []

Tip

Je kunt CTRL+W gebruiken om te zoeken naar letsencrypt['contact_emails'] en Enter drukken, zodat je niet het hele bestand handmatig hoeft te doorzoeken.

Als je klaar bent, druk je op CTRL+X, dan Y en Enter om de wijzigingen op te slaan.

Voer tot slot het volgende commando uit om GitLab met de nieuwe instellingen opnieuw te configureren:

Code

sudo gitlab-ctl reconfigure

Dit proces kan even duren omdat GitLab wordt geïnitialiseerd met de bijgewerkte configuratiegegevens. Als er een domein is gebruikt, worden ook de SSL-certificaten automatisch uitgegeven.

Stap 4: Toegang tot de webinterface

Na de initialisatie zou de server nu via een webbrowser bereikbaar moeten zijn. Open je pagina door je domein of IP-adres in te voeren:

Code

https://[jouw_domein] OF http://[jouw_ip_adres]

Bij de eerste toegang verschijnt de inlogpagina.

Voor de eerste login gebruik je de gebruiker root.

Het wachtwoord vind je in een bestand op je Linux-server. Open het bestand met het volgende commando en zoek het veld Password:

Code

sudo nano /etc/gitlab/initial_root_password

Code

# WAARSCHUWING: Deze waarde is alleen geldig onder de volgende voorwaarden

# 1. Als het handmatig is ingesteld (via de `GITLAB_ROOT_PASSWORD` omgevingsvariabele of `gitlab_rails['initial_root_password']` instelling in `gitlab.rb` vóór de eerste databasevulling).

# 2. Het wachtwoord is niet handmatig gewijzigd, noch via UI noch via commandoregel.

#

# Als het hier getoonde wachtwoord niet werkt, moet je het admin-wachtwoord resetten: https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.

Password: `[JOUW_WACHTWOORD_HIER]`

# OPMERKING: Dit bestand wordt automatisch verwijderd na de eerste reconfigure-run binnen 24 uur.

Voer gebruikersnaam en wachtwoord in op de inlogpagina om voor het eerst je GitLab-dashboard te openen. Je hebt nu toegang tot je GitLab-paneel op je eigen Linux-server.

We raden sterk aan om een nieuwe gebruiker aan te maken en/of het wachtwoord van de root gebruiker te wijzigen. Dit kun je doen via Admin linksonder en dan Overzicht -> Gebruikers. Daar kun je alle gebruikers van je GitLab-instantie beheren.

Optioneel: Firewall instellen met ufw

Deze stap kun je overslaan als je geen firewall wilt configureren of bijvoorbeeld al firewalld op OpenSUSE gebruikt. Zorg dat poorten 80/443 en 22 openstaan.

ufw installeren

Als ufw al geïnstalleerd is, kun je deze stap overslaan.

bash

sudo apt-get install -y ufw

bash

sudo zypper install ufw

Benodigde poorten openen

Code

sudo ufw allow http
sudo ufw allow https
sudo ufw allow OpenSSH

Firewall activeren

[!WAARSCHUWING] Standaard blokkeert ufw dan alle andere poorten behalve de toegestane. Zorg dat je whitelist correct is voordat je dit commando uitvoert.

Activeer de firewall met:

Code

sudo ufw enable

Conclusie

Gefeliciteerd, je hebt GitLab succesvol geïnstalleerd! Als je nog vragen of problemen hebt, staat ons supportteam dagelijks voor je klaar om je te helpen!

Als je verdere instellingen wilt doen, raden we je aan de officiële GitLab-documentatie te lezen voor de volgende stappen.

FAQ

Veelgestelde vragen

Je kunt GitLab direct via One-Click Apps in het VPS-webinterface installeren door in de app-catalogus naar GitLab te zoeken en de installatie te starten met je gewenste project-, omgeving- en domeininstellingen.

Minimaal 2x 2 GHz CPU, 4 GB RAM, 10 GB opslag en 100 Mbit/s bandbreedte (up & down). Aanbevolen zijn 4x 2,6+ GHz CPU, 8 GB RAM en 50+ GB opslag.

GitLab is een uitgebreid DevOps-platform waarmee teams samen aan code werken, workflows automatiseren en de volledige softwareontwikkelingscyclus efficiënt beheren.

Feedback

Was dit artikel nuttig?

Je feedback helpt ons inhoud beter te prioriteren en te verbeteren.

0 van 0 Gebruikers vonden dit artikel nuttig.

Persoonlijke hulp

Is de handleiding niet voldoende?

Onze ZAP-support kent je product — beschrijf kort je vraag en wij helpen je persoonlijk verder.

## GitLab URL ##! URL waarop GitLab bereikbaar zal zijn. ##! Voor meer details over het configureren van external_url zie: ##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab ##! ##! Opmerking: Tijdens installatie/updates wordt de waarde van de omgevingsvariabele ##! EXTERNAL_URL gebruikt om deze waarde in te stellen/te vervangen. ##! Bij AWS EC2-instanties wordt geprobeerd de publieke hostnaam/IP ##! van AWS op te halen. Meer info: ##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html external_url 'http`s`://`Jouw domein / IPv4-adres van je Linux-server`'

################################################################################ # Let's Encrypt Integratie ################################################################################ # letsencrypt['enable'] = nil # letsencrypt['contact_emails'] = [`Jouw e-mail hier`] # Dit moet een array van e-mailadressen zijn # letsencrypt['group'] = 'root' # letsencrypt['key_size'] = 2048 # letsencrypt['owner'] = 'root' # letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www' # Zie https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically voor meer info # letsencrypt['auto_renew'] = true # letsencrypt['auto_renew_hour'] = 0 # letsencrypt['auto_renew_minute'] = nil # Moet een getal of cron-expressie zijn, indien opgegeven. # letsencrypt['auto_renew_day_of_month'] = "*/4" # letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt' # letsencrypt['alt_names'] = []

Welke 🍪 cookies sta je toe?

GitLab op een Linux-server installeren – Host je eigen DevOps-platform

Inleiding

GitLab installeren met One-Click Apps

Voorbereiding

Hardware

Software

Stap 1: Afhankelijkheden installeren

Stap 2: GitLab installeren

Stap 3: GitLab configureren

Stap 4: Toegang tot de webinterface

Optioneel: Firewall instellen met ufw

ufw installeren

Benodigde poorten openen

Firewall activeren

Conclusie

Veelgestelde vragen

Software

GitLab installeren met One-Click Apps

Stap 1: Afhankelijkheden installeren

Stap 2: GitLab installeren

Stap 3: GitLab configureren

Stap 4: Toegang tot de webinterface

Optioneel: Firewall instellen met ufw

ufw installeren

Benodigde poorten openen

Firewall activeren

Conclusie

Gameserver

Servers en hosting

ZAPX

Resources

ZAP-Hosting