Buster Fast Track (Recommended)
Gitlab 12.6.8 is available in unofficial fasttrack repo (some packages are still needed from personal repo of gitlab maintainer) targeting buster as base distribution. (no open security issues).
Add to /etc/apt/sources.list
deb http://fasttrack.debian.net/debian/ buster-fasttrack main contrib deb http://fasttrack.debian.net/debian/ buster-backports main contrib deb https://deb.debian.org/debian buster-backports contrib main # Eventually the packages in this repo will be moved to one of the previous two repos deb https://people.debian.org/~praveen/gitlab buster-backports contrib main
# apt update
You may encounter the following error message:
If so, those commands can help:
# wget https://people.debian.org/~praveen/gitlab/praveen.key.asc # wget http://fasttrack.debian.net/fasttrack-archive-key.asc # apt-key add praveen.key.asc # apt-key add fasttrack-archive-key.asc
# apt -t buster-backports install gitlab
Note: https://gitlab.debian.net is running on this version.
Unstable (be careful when updating packages)
Gitlab 12.6.8 is available in unstable (no open security issues), but requires backporting https://gitlab.com/gitlab-org/gitlab/-/merge_requests/27276 to work correctly with ruby 2.7. Please use experimental.
Note: Use ruby-excon and ruby-aws-sdk from experimental until they can be uploaded to unstable
# apt install gitlab ruby-excon/experimental ruby-aws-sdk/experimental
Experimental - During freeze and transitions
Gitlab 12.8.6 is available experimental (no open security issues). But ruby-stackprof is still in NEW, for now you can build this from its git repo.
If you are using experimental for the first time, check DebianExperimental.
Some transitions (list below, mainly rails 6) are delaying upload to unstable.
Install some dependencies from experimental,
# apt install ruby-aws-sdk/experimental ruby-excon/experimental # apt -t experimental install ruby-rails ruby-doorkeeper ruby-doorkeeper-openid-connect \ ruby-elasticsearch ruby-gitaly ruby-gitlab-labkit ruby-rails ruby-rails-i18n \ ruby-railties ruby-responders ruby-devise ruby-devise-two-factor \ ruby-state-machines-activemodel ruby-acts-as-taggable-on ruby-redis-actionpack
Currently gitlab installation is broken due to a change in libsass. A work around is to downgrade libsass and libsass-dev to 3.6.1. Use http://snapshot.debian.org/package/libsass/3.6.1-1/
Now install gitlab from experimental,
# apt install git && apt install gitlab/experimental
Gitlab on Stretch
This is moved to gitlab/stretch now.
Gitlab with apache2
Debug installation and configuration
Gitlab is composed of several parts. As always logs (/var/log/gitlab), debian specific documentation (/usr/share/doc/gitlab/) and (official) documentation provide lots of information.
gitlab-rake is convenience script to easily run rake commands provided by gitlab in debian environment.
# gitlab-rake gitlab:check # gitlab-rake gitlab:env:info
gitlab-rails-console is another convenience script to launch a rails console in gitlab debian environment.
You can reach the maintainers of the gitlab package via
Matrix at #debian-gitlab:poddery.com (join via browser)
IRC #debian-gitlab on OFTC network (join via browser)
Installing gitlab on an lxc container to test - See gitlab/lxc
Updating gitlab package to newer versions - See Teams/Ruby/Packaging/newUpstreamRailsApp
Backport/Fasttrack checklist - See gitlab/BackportChecklist
Dependencies Transitions checklist - See gitlab/DependenciesTransitions
Managing Components - See gitlab/ManagingComponents
Plan to move gitlab-common binary to gitlab-shell source package - See ?gitlab/gitlab-common-to-gitlab-shell-plan
Aim to get gitlab back in main by bullseye release by packaging all node dependencies. current status This is now an Outreachy project (from December 2019 to March 2020).
- Get autopkgtest working so we can detect problems when someone updates dependencies without coordinating with us.
Note: this section is about the installation of upstream-provided unofficial packages.
all actions are performed under the root user, in ~ unless otherwise noted.
navigate to https://about.gitlab.com/install/ and copy down the link to the Debian deb package.
as of this writing @ June 5, 2014
- dpkg -i gitlab*
i got errors 1st time around 2nd time around gitlab looked like it set everything and ran well.
To avoid errors, execute /opt/gitlab/embedded/bin/runsvdir-start for one minute, more or less (tested in 7.9.0 and 7.9.1 omnibus versions).
- gitlab-ctl reconfigure
to verify that things are running
- gitlab-ctl status
navigate to your servers IP address or domain name, and login as:
user: root password: 5iveL!fe