This is a docker based GitLab CE package for Synology NAS server using the original gitlab/gitlab-ce image from hub.docker.com. The goal of this project is to lower the entry barrier for new GitLab users and give experienced users a little comfort in maintaining their GitLab installation.
Everything this package does, can be also done manually over the Synology Docker NAS Application.
Please note that I can not give you support for GitLab itself, this project covers only the Synology installation/update routines. If you need GitLab Support you might get it here https://forum.gitlab.com.
You can download the SPK file in the Releases section.
- 1 CPU core ( 2 cores is recommended )
- 2 GB RAM ( 4GB RAM is recommended )
- DSM 6.0 and DSM 7.0 compatible
very simplistic package, installation and basic configuration over DSM, no ssh or root privileges required. But this comes with a tradeoff, container configuration (ports,volumes,etc.) after the installation is not possible. This is because of the DSM no root privilege policy. However the settings can be changed but only by uninstalling and reinstalling the package again. During uninstallation of this package all data will be deleted by DSM. Please do not forget to backup before. Upgrade to Advanced is possible, but be careful and backup, backup, backup!
WARNING: All gitlab data will be deleted on uninstall! Backup berfore uninstalling!
this approach bypass the root privileges limitation of the DSM by running the setup over ssh. The final container runs exactly with the same privileges and setup as the classic non-root approach but you need to execute the installer as root to get the setup done. This is a more flexible variant because this way you get the full access to the container settings and an update simply exports you current container configuration and imports it again with a modified GitLab image version. This way all your configuration remains the same and you can downgrade and upgrade as you like. As far as GitLab supports the downgrade with your specific dataset. The ssh installer/updater gives you also the ability to run multiple gitlab container instances with different container/versions and different data shares. You can test your upgrades and migrations without any risk and downtime.
Feature | Advanced | Classic |
---|---|---|
DSM only install | ✗ | ✓ |
requires ssh for install | ✓ | ✗ |
requires root privileges | ✓ | ✗ |
gitlab can be upgraded | ✓ | ✓ |
gitlab can be downgraded | ✓ | ✗ |
multiple parallel gitlab instances | ✓ | ✗ |
start/stop over Synology Package Manager | ✗ | ✓ |
start/stop over Synology Docker app | ✓ | ✗ |
exposed gitlab configuration and data | ✓ | ✓ |
container settings accessible | ✓ | ✗ |
access to container environment variables | ✓ | ✗ |
keeps container settings (ports, volumes, links) on updates | ✓ | ✗ |
GitLab files (data, config) remains on package uninstall | ✓ | ✗ |
Clone this repository and execute the build.sh shell script within your terminal application. This can be done on any linux and should also work on WSL. Except "jq" there are no special packages/binaries required.
# Syntax: build.sh [options]
# options:
# --version - GitLab CE version e.g. 13.4.3-ce.0,
# when no version given, a selection list of the latest
# available versions is shown
# --type - package type (classic|advanced) - default: classic
# --dsm - target DSM version (6|7) - default: 7
./build.sh --version=13.4.3-ce.0 --dsm=7 --type=classic
# Location: /var/packages/synology-gitlab-ce/scripts
# Syntax: gitlab <action> <container> [options]
# arguments:
# action - install or update
# container - container name
# options:
# --version - GitLab CE version e.g. 13.4.3-ce.0
# --share - destination folder which will contain shared gitlab files
# --port-ssh - ssh host port
# --port-http - http host port
# --port-https - https host port
# install
cd /var/packages/synology-gitlab-ce/scripts && \
sudo sh gitlab install synology-gitlab-ce \
--version=13.4.3-ce.0 \
--share=synology-gitlab-ce \
--port-ssh=30022 \
--port-http=30080 \
--port-https=30443
# update
cd /var/packages/synology-gitlab-ce/scripts && \
sudo sh gitlab update synology-gitlab-ce --version=13.4.5-ce.0
If you want to bash into your gitlab container you can do this with this command
sudo docker exec -it "<gitlab-container-name>" bash
If you forgot your password or after the install GitLab does not redirect you to the password reset form. You can reset your password from the command line. On a fresh install the main user is 'root'. See also the documentation.
sudo docker exec -it "<gitlab-container-name>" bash -c "gitlab-rake 'gitlab:password:reset'"
For configuration of the omnibus based GitLab image please refer to this documentation https://docs.gitlab.com/omnibus/settings.
# after any change to the gitlab configuration you need to reconfigure
# gitlab and restart the services, which can be done with this two
# commands from your ssh terminal
sudo docker exec -t "<gitlab-container-name>" bash -c "gitlab-ctl reconfigure"
sudo docker exec -t "<gitlab-container-name>" bash -c "gitlab-ctl restart"
This helper installs for you a self-signed SSL certificate to your gitlab container and configures your gitlab to use this. Please do not use this for public accessible instances, this approach only makes sense if you run your GitLab private on your LAN and you're lazy to do a proper SSL certificate and install it. In any other case i recommend you to use the GitLab Let's Encrypt integration.
# Location: /var/packages/synology-gitlab-ce/scripts
# Syntax: gitlab-self-signed-cert <action> [<container>] [options]
# arguments:
# action - install
# container - container name
# options:
# --hostname - gitlab hostname - default: xpenology
# --https-port - https port - default: 80443
cd /var/packages/synology-gitlab-ce/scripts && \
sudo sh gitlab-self-signed-cert install synology-gitlab-ce \
--hostname=xpenology --https-port=80443
If your GitLab shortcut in your DSM got broken or points to the wrong container (port) you can fix it with this helper anytime.
# Location: /var/packages/synology-gitlab-ce/scripts
# Syntax: gitlab-link-fix [options]
# options:
# --protocol - protocol http|https - default: http
# --port - port - default: 30080
cd /var/packages/synology-gitlab-ce/scripts && \
sudo sh gitlab-link-fix --protocol=https --port=30443
Please refer to this documentation here. It is not recommended to store data backups in the same location as your config/credentials backup. Because of this, the backup process is split into two steps, the config backup and the data backup.
# backup gitlab configuration
# you will find you backups in this folder
# /docker/<gitlab-container-share>/config/config_backup
sudo docker exec -it "<gitlab-container-name>" gitlab-ctl backup-etc
# backup gitlab data (repositories and content)
# you will find you backups in this folder
# /docker/<gitlab-container-share>/data/backups
sudo docker exec -it "<gitlab-container-name>" gitlab-backup
Please refer to the GitLab documentation here.
# restore gitlab configuration
# unzip your configuration backup to the config folder overwriting existing files
# config folder: /docker/<gitlab-container-share>/config
# after that you can continue with the data restore
# restore gitlab data
# copy your data backup to the data/backups folder
# /docker/<gitlab-container-share>/data/backups
sudo docker exec -it "<gitlab-container-name>" gitlab-ctl stop puma
sudo docker exec -it "<gitlab-container-name>" gitlab-ctl stop sidekiq
# verify puma & sidekiq are down
sudo docker exec -it "<gitlab-container-name>" gitlab-ctl status
# fix permissions
sudo docker exec -it "<gitlab-container-name>" chown git:git /var/opt/gitlab/backups/1647529095_2022_03_17_13.4.3_gitlab_backup.tar
# restore, please omit the "_gitlab_backup.tar" from the backup archive name
sudo docker exec -it "<gitlab-container-name>" gitlab-backup restore BACKUP=1647529095_2022_03_17_13.4.3
# restart the GitLab container
sudo docker restart "<gitlab-container-name>"
# check GitLab
sudo docker exec -it "<gitlab-container-name>" gitlab-rake gitlab:check SANITIZE=true
Migration from synology-gitlab package
Migration can only be done within the same GitLab version. Its is basically a backup from synology-gitlab package and restore to the synology-gitlab-ce package.
# backup config
# @todo: not found a automated way yet
# here is the config located but its structure differs from the omnibus package, need
# review and testing. For now, you can look up needed configuration and transfer it
# manually to your new synology-gitlab-ce instance
sudo docker exec -w "/home/git/gitlab/config" -it synology_gitlab bash
# backup data
sudo docker exec -it synology_gitlab bash -c "sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production CRON=1"
# The synology-gitlab psql user differs from the synology-gitlab-ce so we need to
# modify the database dump. Simply replace the "gitlab_user" with "gitlab".
# The tools/fix_synology_gitlab_backup does that for you.
# Syntax: fix_synology_gitlab_backup <file>
# arguments:
# file - path to your gitlab_backup.tar file
./tools/fix_synology_gitlab_backup 1647548012_2022_03_17_13.9.3_gitlab_backup.tar
# you will get a 1647548012_2022_03_17_13.9.3_gitlab_backup.tar.new file as output which
# is ready for restore. Now you can process with the regular restore procedure above,
# please do not forget to remove the ".new" suffix from file.
# NOTE: if you get following errors, they seems to be common. Despite the errors the
# restore seems to work, further investigation needed.
# See: https://gitlab.com/gitlab-org/gitlab/-/issues/266988
#
# Restoring PostgreSQL database gitlabhq_production ... ERROR: must be owner of extension pg_trgm
# ERROR: must be owner of extension btree_gist
# ERROR: must be owner of extension btree_gist
# ERROR: must be owner of extension pg_trgm
#
# See: https://gitlab.com/gitlab-org/gitlab/-/issues/266988#note_430408658
# Regarding to this post is everything fine as far as the restore doesn't break.
# Quote: "We ignore 'does not exist' and 'must be owner' of errors"