- The package repository is recommended over a manual install
- Downloading a GitLab Package
- Installing the GitLab Package
- Browse to the hostname and login
We recommend downloading and installing GitLab using the official package repository. If you prefer, you can download and install an Omnibus GitLab package manually below.
Before installing GitLab, it is of critical importance to review the system requirements. The system requirements include details on the minimum hardware, software, database, and additional requirements to support GitLab.
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 EXTERNAL_URL="http://gitlab.example.com" dpkg -i gitlab-ee-9.5.2-ee.0_amd64.deb
- RPM based (CentOS, RHEL, Oracle, Scientific, openSUSE, SLES):
sudo EXTERNAL_URL="http://gitlab.example.com" rpm -i gitlab-ee-9.5.2-ee.0.el7.x86_64.rpm
http://gitlab.example.com to the URL at which you want to access your GitLab instance. Installation will automatically configure and start GitLab at that URL.
Note: Enabling HTTPS will require additional configuration to specify the certificates.
On your first visit, you’ll be redirected to a password reset screen. Provide the password for the initial administrator account and you will be redirected back to the login screen. Use the default account’s username
root to login.