index.html.haml 11.6 KB
---
layout: default
title: Installation methods for GitLab
suppress_header: true
extra_css:
  - installation.css
---
.wrapper
  .installation-header
    = partial "includes/icons/gitlab-icon-pattern-header.svg"
    .container
      .installation-content
        %h1 GitLab Installation
        %h2
          Below are all the options to create a GitLab installation. If you're not sure which method to choose, please use the Omnibus package installation method.
  #content
    .wrapper.container
      .col-md-12.col-sm-12{role: "main"}
        .method.omnibus
          %h2.block-title{id: "#omnibus"} Omnibus package installation (recommended)
          .row
            .col-md-10.col-md-offset-1
              %p
                We recommend installing the Omnibus package instead of installing GitLab from source.
                %a{href: "https://twitter.com/awc737/status/517902687052898305"} 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
                = succeed "." do
                  %a{href: "https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/README.md"} Omnibus GitLab readme
          %ul.gl-editions
            %li.btn-wrap
              %a.btn{ href: "/downloads" }
                = partial "includes/logos/logo_sq.svg"
                %span.package-name
                  %span
                    GitLab
                    %strong
                      CE
                  %small
                    packages
            %li.btn-wrap
              %a.btn{ href: "/downloads-ee" }
                = partial "includes/logos/logo_sq.svg"
                %span.package-name
                  %span
                    GitLab
                    %strong
                      EE
                  %small
                    packages
        .method.upgrade
          %h2.block-title Update your GitLab instance
          %p
            Latest Release:
            %span= "v#{current_version}"
          %p
            %a.btn.cta-btn.red{href: "/update"}
              View update options for CE & EE
        #other-methods.method
          %h2 Other official installation methods
          %ul
            %li
              %p
                %a{href: "https://gitlab.com/gitlab-org/gitlab-development-kit/blob/master/README.md"} GitLab Development Kit
                lets you install GitLab for development purposes, it is isolated in a directory and runs with a single make command
            %li
              %p
                %a{href: "https://gitlab.com/gitlab-org/cookbook-omnibus-gitlab/blob/master/README.md"} GitLab Omnibus Cookbook
                can be used for production
                %a{href: "https://www.getchef.com/chef/"} Chef
                installations
            %li
              %p
                %a{href: "https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/install/installation.md"} Installation from source guide
                to set up a production server on Ubuntu with detailed and complete step-by-step instructions
            %li
              %p
                %a{href: "https://gitlab.com/gitlab-org/gitlab-ce/tree/master/docker"} Docker installation instructions
                for a container based on the Omnibus packages
            %li
              %p
                %a{href: "/aws"} Amazon Web Services (AWS)
                AMI's for GitLab Community Edition and Enterprise Edition
            %li
              %p
                %a{href: "https://azure.microsoft.com/en-us/"} Microsoft Azure
                is Microsoft's business cloud. Through the Azure Marketplace, you can spin up a pre-configured GitLab VM in just a few clicks.
                Get started with
                = succeed "." do
                  %a{href: "/2016/07/13/how-to-setup-a-gitlab-instance-on-microsoft-azure/"} this tutorial
            %li
              %p
                %a{href: "https://store.docker.com/"} Docker Store
                is the marketplace for trusted and validated dockerized software. You can download a certified GitLab docker image for
                %a{href: "https://store.docker.com/images/252cc2ea-82ae-4a06-b6fb-c722bf645843"} the Community Edition
                and
                %a{href: "https://store.docker.com/images/17d3e8e0-3e15-418a-a8d6-3dc5e4c21654?tab=description"} Enterprise Edition
                on Docker Store.
            %li
              %p
                %a{href: "http://docs.pivotal.io/partners/gitlab/"} GitLab Tile
                for
                %a{href: "https://pivotal.io/platform"} Pivotal Cloud Foundry
                provides an easy, scalable installation for
                %a{href: "https://about.gitlab.com/products/"} GitLab Enterprise Edition Premium
                customers on their own PCF infrastructure.
            %li
              %p
                %a{href: "https://mesosphere.com/product/"} Mesosphere DC/OS
                universe has GitLab CE and EE packages available for one-click installation. Check out
                = succeed "." do
                  %a{href: "https://mesosphere.com/blog/2016/09/16/gitlab-dcos/"} this article for instructions and more resources.
            %li
              %p
                %a{href: "https://kubernetes.io/"} Kubernetes
                users can install GitLab using the official Helm chart with the package manager. Check out
                = succeed "." do
                  %a{href: "https://github.com/kubernetes/charts/tree/master/stable/gitlab-ce"} official helm repo for the chart and instructions
            %li
              %p
                %a{href: "https://www.openshift.com/"} RedHat OpenShift
                template for installing GitLab CE. Check out
                = succeed "." do
                  %a{href: "https://about.gitlab.com/2016/06/28/get-started-with-openshift-origin-3-and-gitlab"} this article for instructions.
        .method
          %h2#one-click-install-providers One-click install providers
          %p
            One-click installers are frequently out of date and might not contain our Omnibus packages.
            We advise to
            %b 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.
          %ul
            %li
              %p
                %a{href: "https://www.digitalocean.com/features/one-click-apps/gitlab/"} Digital Ocean 1-Click Application Install
                gets a new server up in 55 seconds with fast SSD disks. We recommend selecting a droplet with
                = succeed "." do
                  %a{href: "https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/install/requirements.md#memory"} 2GB of memory
                Get started with this
                %a{href: "https://www.digitalocean.com/company/blog/host-your-git-repositories-in-55-seconds-with-gitlab/"} blog post
                and
                %a{href: "https://www.digitalocean.com/community/tutorials/how-to-use-the-gitlab-one-click-install-image-to-manage-git-repositories"} tutorial
            %li
              %p
                %a{href: "https://app.cloud66.com/easydeploys"} Cloud 66 deployment and management
                to deploy GitLab to your own server or any cloud (DigitalOcean/AWS/Rackspace/GCE/etc.) and then manage it with database backups, scaling and more
            %li
              %p
                %a{href: "https://packager.io/gh/gitlabhq/gitlabhq"} Packager.io
                provides autogenerated debian or rpm packages of GitLab for Debian, Ubuntu, and CentOS/RHEL
            %li
              %p
                %a{href: "https://d9tready.com/store/developer/gitlab"} d9tready
                lets you deploy GitLab on their cloud service hosted in Germany
            %li
              %p
                %a{href: "https://cloudron.io"} Cloudron.io
                has a
                %a{href: "https://cloudron.io/appstore.html#com.gitlab.cloudronapp"} GitLab app
                that can be installed on your Cloudron Smartserver. They actively track GitLab releases (
                %a{href: "https://git.cloudron.io/cloudron/gitlab-app"} source
                ) keeping your installation up-to-date.
        .method
          %h2 Community installation methods
          %ul
            %li
              %p
                %a{href: "http://packages.ubuntu.com/search?keywords=gitlab&searchon=names&suite=all&section=all"} 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)
            %li
              %p
                %a{href: "https://packages.debian.org/search?keywords=gitlab"} 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)
            %li
              %p
                %a{href: "https://forge.puppetlabs.com/vshn/gitlab"} Puppet module
                by VSHN AG based on the Omnibus packages
            %li
              %p
                %a{href: "https://gitlab.com/bjk-gitlab/ansible-gitlab-ce"} Ansible playbook
                by Ben Kochie based on the Omnibus packages
            %li
              %p
                %a{href: "https://launchpad.net/ubuntu/+source/gitlab/"} Debian package
                by Pirate Praveen
            %li
              %p
                %a{href: "http://www.freshports.org/www/gitlab"} FreeBSD package
                by Torsten Zühlsdorff
            %li
              %p
                %a{href: "https://www.archlinux.org/packages/community/x86_64/gitlab/"} Arch package
                by Sven-Hendrik Haase
            %li
              %p
                %a{href: "https://github.com/tuminoid/gitlab-installer"} Vagrant option
                by Tuomo Tanskanen
            %li
              %p
                %a{href: "https://gitlab.com/gitlab-org/gitlab-ce/issues/14043"} No Fedora package
                exists yet but we would love to see it, if you can help please comment in the issue
            %li
              %p
                %a{href: "https://gitlab.com/gitlab-org/gitlab-recipes/"} GitLab recipes
                with unofficial guides for using GitLab with different software (operating systems, webservers, etc.) than the official version
        .method
          %h2 GitLab as a Service - Hosted GitLab
          %ul
            %li
              %p
                %a{href: "https://gitlab.com"} GitLab.com
                free, hosted GitLab by GitLab Inc., also the canonical location of the GitLab source code
            %li
              %p
                %a{href: "https://githost.io/"} GitHost.io
                private, managed GitLab instances in the Cloud
        .method
          %h2 Third-party applications
          %ul
            %li
              %p
                %a{href: "/applications"} List of third-party applications that support GitLab.