# GitBucket

> A GitHub-shaped forge that starts from a single WAR file.

Status: active. Verified 14 November 2026. Category: Self-hosted forges. Website: https://gitbucket.github.io/

GitBucket is a Scala reimplementation of the GitHub interface, deliberately close to the original in both layout and vocabulary. It provides issues, pull requests, a wiki and a plugin system, and installs by running one WAR file on any machine with a Java runtime. It has been maintained continuously since 2013, and it suits a team that wants GitHub's layout on its own server.

## At a glance

| | |
|---|---|
| Hosting | Self-hosted (JVM) |
| Licence | Apache 2.0 |
| Free tier | Free and unlimited |
| Paid plans | None |
| CI/CD | Integrations |
| Issue tracker | Yes |
| Reads Actions YAML | No |
| Imports from GitHub | Code only |
| SAML / SSO | Yes, LDAP and OIDC |
| Used by | No large public deployments are advertised. Maintained continuously since 2013. |

Starts with java -jar gitbucket.war. It ships with an embedded H2 database, so no separate database server is needed to begin.

## Strengths

- One WAR file, with no database server or reverse proxy needed to start
- Interface closely mirrors GitHub, so there is little to relearn
- LDAP and OpenID Connect are both supported

## Trade-offs

- No built-in CI; it expects Jenkins or another external system
- Smaller community and slower feature pace than Gitea or Forgejo
- Needs a JVM, which is heavier than a Go single binary

## Moving from GitHub

The documented route is a mirror push, which carries code, branches and tags. Issues and pull requests stay behind. CI moves to Jenkins, for which GitBucket publishes integration guides.

## FAQ

### Is GitBucket free?

Free tier: Free and unlimited. Paid plans: None.

### What licence is GitBucket under?

Apache 2.0.

### Can GitBucket be self-hosted?

Hosting: Self-hosted (JVM).

### Does GitBucket have CI and read GitHub Actions workflows?

CI/CD: Integrations. Reads GitHub Actions YAML: No. Imports from GitHub: Code only.

### How do I move from GitHub to GitBucket?

The documented route is a mirror push, which carries code, branches and tags. Issues and pull requests stay behind. CI moves to Jenkins, for which GitBucket publishes integration guides.

Source: https://github.com/gitbucket/gitbucket/wiki

Not affiliated with GitBucket, GitHub, Inc. or Microsoft Corporation. All 45 platforms: https://githubalternatives.com/
