Omnibus package installation (recommended)

We recommend installing the Omnibus package instead of installing GitLab from source. Omnibus GitLab takes just 2 minutes to install and is packaged in the popular deb and rpm formats. Compared to an installation from source, the Omnibus package is faster to install and upgrade, more reliable to upgrade and maintain, and it shortens the response time for our subscribers' issues. A package contains GitLab and all its dependencies (Ruby, PostgreSQL, Redis, Nginx, Unicorn, etc.), it can be installed without an internet connection. For troubleshooting and configuration options please see the Omnibus GitLab readme.

Update your GitLab instance

Other official installation methods

One-click install providers

One-click installers are frequently out of date and might not contain our Omnibus packages. An example of this are the Bitnami packages in the past couldn't be updated and are now much harder to update than the Omnibus packages. We advise to not use one-click installers but instead start an vanilla Ubuntu instance and use the recommended Omnibus package installation. This is almost as quick as a one-click install and you're sure of the latest version and easy upgrades.

Community installation methods

  • Ubuntu package by Masters of the Universe based on the Debian package install GitLab on Ubuntu 16.04 and higher with just `apt-get install gitlab` (we do recommend to use the official Omnibus package instead for faster updates and higher reliability)

  • Debian package by Pirate Praveen install GitLab on Debian Stretch and higher with just `apt-get install gitlab` (we do recommend to use the official Omnibus package instead for faster updates and higher reliability)

  • Puppet module by VSHN AG based on the Omnibus packages

  • Debian package by Pirate Praveen

  • FreeBSD package by Torsten Z├╝hlsdorff

  • Arch package

  • Vagrant option by Tuomo Tanskanen

  • No Fedora package exists yet but we would love to see it, if you can help please comment in the issue

  • RedHat OpenShift template

  • GitLab recipes repository with unofficial guides for using GitLab with different software (operating systems, webservers, etc.) than the official version

  • Unofficial installation guides on the public wiki to install GitLab on different operating systems

GitLab as a Service - Hosted GitLab

  • GitLab.com free, hosted GitLab by GitLab Inc., also the canonical location of the GitLab source code

  • GitHost.io private, managed GitLab instances in the Cloud