Skip to content

Install as a systemd Service

aadrian edited this page Oct 15, 2017 · 1 revision


Unpack the GitBucket Zip distribution to /opt .

Running as a Service

Followings will be assumed:

  • Java 8 is running correctly with /usr/bin/java
  • Install directory is /opt/gitbucket
  • The GitBucket (java) process will run as user gitbucket and group gitbucket, with UID and GID 555
  • A non-root user account that can use sudo to execute commands as root will be the example
  1. Add the user and the group:
sudo groupadd -g 555 gitbucket

sudo useradd \
  -g gitbucket --no-user-group \
  --home-dir /opt/gitbucket --no-create-home \
  --shell /usr/sbin/nologin \
  --system --uid 555 gitbucket
  1. Make the owner of the GitBucket to be the gitbucket:gitbucket user:
sudo chown -R gitbucket:gitbucket /opt/gitbucket
  1. Change gitbucket.service to suit your needs. Especially line 18. Consult for further details.

  2. Install the systemd service unit configuration file, reload the systemd daemon, and start GitBucket:

sudo cp gitbucket.service /etc/systemd/system/
sudo chown root:root /etc/systemd/system/gitbucket.service
sudo chmod 644 /etc/systemd/system/gitbucket.service
sudo systemctl daemon-reload
sudo systemctl start gitbucket.service
  1. Start GitBucket automatically when booting:
sudo systemctl enable gitbucket.service
  1. If GitBucket is not starting properly, view the logs:
journalctl --boot -u gitbucket.service

or just follow the logs with:

journalctl -f -u gitbucket.service
You can’t perform that action at this time.