- Manually Downloading and Installing a GitLab Package
If you do not want to use the official GitLab package repository, you can download and install a Omnibus Gitlab package manually.
All GitLab packages are posted to our package server and can be downloaded. We maintain five repos:
- GitLab EE: for official Enterprise Edition releases
- GitLab CE: for official Community Edition releases
- Unstable: for release candidates and other unstable versions
- Nighty Builds: for nightly builds
- Raspberry Pi 2: for Raspberry Pi 2 packages
Browse to the repository for the type of package you would like, in order to see the list of packages that are available. There are multiple packages for a single version, one for each supported distribution type. Next to the filename is a label indicating the distribution, as the file names may be the same.
Locate the desired package for the version and distribution you want to use, and click on the filename to download.
With the desired package downloaded, use your systems package management tool to install it. For example:
- DEB based (Ubuntu, Debian, Raspberry Pi):
sudo dpkg -i gitlab-ee-9.5.2-ee.0_amd64.deb
- RPM based (CentOS, RHEL, Oracle, Scientific, openSUSE, SLES):
sudo rpm -i gitlab-ee-9.5.2-ee.0.el7.x86_64.rpm
Installation may take a few minutes to complete. Once installed, GitLab should now be configured.
With GitLab installed, the next step is to configure it and start the services. The settings for GitLab are contained in
/etc/gitlab/gitlab.rb. There are a variety of settings which can be configured, but the most important is setting the external URL.
Note: Enabling HTTPS will require additional configuration to specify the certificates.
To configure the external URL:
/etc/gitlab/gitlab.rbin your favorite text editor
- Find the line near the top for
- Change the URL to be the URL of your GitLab server
- Save the file and exit your text editor.
With the required settings configured, GitLab can now be started. To do this run:
sudo gitlab-ctl reconfigure
This command will read the settings and apply them to the GitLab installation, then start all services. This will take a few minutes to complete, and you will see lines of white and green text appear.
Once finished, your GitLab server is now ready to be accessed by the URL you configured.