GitLab requires a valid subscription license. Certain features, such as the ability to push to a repository, are not available without a valid license. To request licenses, please contact your Perforce sales representative or email sales at perforce dot com.

As of GitSwarm 2016.3-2, the GitLab package will check, prior to installation, if user['home'] is set to a reserved directory (/opt/gitswarm, /opt/gitlab, /opt/perforce or /opt/rh). If it is set to a reserved directory, the package installation will fail with an error like the following:

ERROR:
ERROR: "user['home']" set to reserved directory '/opt/gitswarm'.
ERROR: '/opt/gitswarm', /opt/gitlab', '/opt/perforce' and '/opt/rh' are reserved directories
ERROR: for GitLab and should not be used for "user['home']".
ERROR:
ERROR: Please edit:
ERROR:
ERROR: /opt/perforce/package-control/helix-gitswarm.config-overrides
ERROR:
ERROR: update "user['home']" and ensure that it is not set to a reserved
ERROR: directory (as listed above).
ERROR: If you are upgrading your GitLab installation, please migrate
ERROR: your installation to the new setting for "user['home']" before
ERROR: attempting to upgrade your GitLab installation. Detailed instructions
ERROR: on how to migrate your home directory can be found in our online
ERROR: documentation here:
ERROR:
ERROR: https://www.perforce.com/perforce/doc.current/manuals/gitswarm/update/README.html#changing-gits-home-directory
ERROR:

If you encounter this error on a new installation of GitLab, please create/edit /opt/perforce/package-control/helix-gitswarm.config-overrides and add/edit the key

user['home']

setting it to a directory that is not reserved. After changing the path, please retry the installation of GitLab.

This error occurs during install of CentOS/RHEL 6.6+, often in a shared VM environment where some of the keys in /etc/sysctl.conf don't actually apply. The error usually looks something like this:

STDERR: error: "net.bridge.bridge-nf-call-ip6tables" is an unknown key
error: "net.bridge.bridge-nf-call-iptables" is an unknown key
error: "net.bridge.bridge-nf-call-arptables" is an unknown key

These errors are ignorable, you just need to run sudo gitlab-ctl reconfigure, and our script shouldn't have to modify that file again and will continue. If you want to future-proof upgrades from failing on the same lines, you can modify your /etc/sysctl.conf and comment out the keys that were listed as unknown.