GitLab Deployment Overview¶

Prerequisites¶

The following conditions are required for successful installation and operation of the application:

Operating System: Ubuntu, Debian (deb-like distributions) or CentOS, Rocky Linux, AlmaLinux (rpm-like distributions).
Access Rights: Superuser (root) privileges to install packages and modify system configurations.
Network Requirements: Internet access to GitLab repositories.

FQDN of the final panel on hostkey.in domain¶

The domain name is generated automatically based on the server ID in the management system.

Parameter	Value
Prefix	`gl`
Domain	`hostkey.in`
Full Template	`gl{Server_ID_from_Invapi}.hostkey.in`

Application Installation Process¶

Installation is performed by adding the official GitLab CE repository followed by compilation/installation of packages via system package managers (apt or yum). After installation, automatic service configuration is performed using parameters from the gitlab.rb file.

Access Rights and Security¶

The following security measures are implemented during deployment:

Firewall: On Red Hat family distributions (CentOS, Rocky, AlmaLinux), the firewalld service is stopped and disabled.
Repository Keys: For Debian/Ubuntu, a modern method of adding keys to the /etc/apt/keyrings/ directory is used.
Administrator Password: The initial root user password for the GitLab web interface is set automatically (the value is retrieved from installation environment variables).

Docker Containers and Execution¶

The application is deployed directly into the operating system as a native service. Use of Docker containers is not supported.

Application Update Instructions¶

Updates are performed via system package updates:

For Debian/Ubuntu: apt update && apt upgrade gitlab-ce
For RHEL-like systems: yum update gitlab-ce

After updating, it is necessary to reconfigure the service using the command: gitlab-ctl reconfigure

Configuration Files and Data Locations¶

The main management and configuration files are located at the following paths:

/etc/gitlab/gitlab.rb — main GitLab configuration file.
/etc/apt/keyrings/gitlab-ce.gpg — repository key (for Debian/Ubuntu).
/etc/apt/sources.list.d/gitlab_gitlab-ce.list — repository list file (for Debian/Ubuntu).

Available Connection Ports¶

The application uses the HTTPS protocol for web interface access via the domain name formed in the FQDN section. Standard port: 443.