selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

gitbucket logo

Self-host gitbucket

4.48.0

Scala-built Git forge with GitHub API compatibility

ReleaseOpen SourceApache-2.0
docker run -d -p 8080:8080 ghcr.io/gitbucket/gitbucket
Updatedlast month
LanguageScala
Setup difficultyEasy
Stars
9 420
Ports
8080 (Web UI / HTTP connector of the standalone server), 8443 (HTTPS connector when the https connector is enabled), 29418 (SSH access to Git repositories (opt-in in system settings))
Docker
ghcr.io/gitbucket/gitbucket
Repository viewer with the file browser and commit historyIssue tracker showing a list of open issues

What is gitbucket?

gitbucket alternatives

Should you self-host gitbucket?

gitbucket scores 67/100 on selfhost.directory (how scoring works) and ranks #6 of 15 in Code Hosting. It has 9 420 GitHub stars, +18 in the last 30 days.

It shipped 6 stable releases in the past year. The latest, 4.48.0, came out on 20 September 2026. New versions land roughly every 6 weeks.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Scala.

Its closest alternative on selfhost.directory is Gitea (89/100, 59 080 stars). It scores higher overall, so compare the two before you pick. See gitbucket vs Gitea side by side.

Features

  • Activity timelineCan be turned off with --disable_news_feed when running several servers.
  • Branch protection
  • Email notifications
  • GitHub-compatible REST APIA subset of the GitHub API is implemented.
  • Git LFS Support
  • Group accounts
  • Issue Tracking
  • LDAP Authentication
  • Online file editor
  • OpenID Connect login
  • Plugin System
  • Public/private Git repositories over HTTP and SSH
  • Pull Requests
  • WebhooksPayloads aim at GitHub compatibility; GitBucket does not fully implement the GitHub webhook.
  • Wiki

gitbucket README

GitBucket Gitter chat build gitbucket Scala version support License

GitBucket is a Git web platform powered by Scala offering:

  • Easy installation
  • Intuitive UI
  • High extensibility by plugins
  • API compatibility with GitHub

GitBucket

How to install gitbucket

Install gitbucket with Docker

Environment variables
GITBUCKET_PORT, GITBUCKET_HOME, GITBUCKET_MAXFILESIZE, GITBUCKET_DB_URL, GITBUCKET_DB_USER, GITBUCKET_DB_PASSWORD, GITBUCKET_BASE_URL
docker run -d -p 8080:8080 ghcr.io/gitbucket/gitbucket

Add -p 29418:29418 option if you would like to enable SSH for repository access:

docker run -d -p 8080:8080 -p 29418:29418 ghcr.io/gitbucket/gitbucket

You can also specify the data directory by -v option:

docker run -d -p 8080:8080 -v `pwd`/gitbucket:/gitbucket ghcr.io/gitbucket/gitbucket

Official image repository is gitbucket-docker; config, DB, git repos and plugins persist in the mounted /gitbucket volume.

How to configure gitbucket

  • GITBUCKET_HOME~/.gitbucketData directory of this GitBucket instance; env-var form of --gitbucket.home. In Docker it is usually mounted outside the container.

    values: path

  • GITBUCKET_PORT8080Port number in the standalone mode (env-var form of --port)

    values: number

  • GITBUCKET_SECUREPORT8443Port number to use with HTTPS (env-var form of --secure_port)

    values: number

  • GITBUCKET_HOSTHost name in the standalone mode (env-var form of --host)

    values: hostname

  • GITBUCKET_CONNECTORShttpComma separated list of connectors to activate (env-var form of --connectors)

    values: http, https

gitbucket releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

How to contribute to GitBucket?

Help is wanted for documentation and wiki text, answering issues, and contributions that follow the project's contributing guidelines and issue/PR templates.

How to backup GitBucket data?

Stop GitBucket and copy the GITBUCKET_HOME directory (~/.gitbucket by default) elsewhere; the wiki has a dedicated backup page for more advanced cases.

gitbucket-gist-plugin doesn't work after upgrading to GitBucket 4.x

A gist plugin installed under GitBucket 3.x keeps an old version row; update that row in the database, restart GitBucket and the plugin migrates to a 4.x-compatible version.

What's limitation of password?

Local passwords may only use alphanumeric characters plus "-", "_" and "."; the docs point users who need stronger credentials to external authorization such as LDAP.

More in Code Hosting

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…