A simple, self-hosted Git registry — your code, your server, your rules.

Features · Tech Stack · Getting Started · Screenshots · Roadmap · License

---

What is OriginHub?

OriginHub is a simple, open-source, self-hosted Git registry inspired by GitHub. It gives you full control over your repositories, pull requests, and CI/CD pipelines — running entirely on your own infrastructure, with zero dependency on third-party platforms.

No subscriptions. No data leaving your servers. No vendor lock-in. Just Git, hosted your way.

OriginHub is built for developers and teams who care about ownership — whether you're an indie developer running it on a VPS, or an enterprise team deploying it on private infrastructure. If you've ever thought "I wish GitHub ran on my own server", OriginHub is for you.

---

✨ Features

📁 Repository Management

• Create, clone, push, and pull repositories
• Private-only repositories for maximum control
• Topics and repository metadata
• Git protocol over SSH (port 2222)

🗂 Code Browsing

• File tree navigation with breadcrumb trail
• Syntax-highlighted code viewer
• Markdown README rendering
• Raw file access
• Commit history with diff viewer

🔀 Pull Requests

• Open, review, and merge pull requests
• Three merge strategies: Merge Commit, Squash, Rebase
• Inline and file-level code comments
• Draft pull requests
• Conversation timeline

⚡ Actions — CI/CD (coming soon)

• YAML-based workflow definitions
• Job and step execution with real-time log streaming (SSE)
• Workflow run history with status filtering
• Trigger on push, pull request, or manual dispatch

🔐 Authentication

• Username + password with JWT
• OAuth2 via Google, GitHub, and GitLab
• SSH key-based authentication

👥 Team Collaboration (coming soon)

• Repository collaborators with permission levels (READ, WRITE, ADMIN)
• User profiles with activity feeds
• Explore page to discover repositories

---

🛠 Tech Stack

Layer	Technology
Language	Java 25
Framework	Spring Boot 4, Spring Security, Spring Data JPA
Git Engine	Eclipse JGit
SSH Server	Apache MINA SSHD
Auth	JWT, OAuth2 (Google · GitHub · GitLab)
Database	PostgreSQL, Flyway
Frontend	Angular 21, TypeScript 5
Styling	Tailwind CSS 4, DaisyUI 5
Container	Docker (multi-stage build, single image)

---

📸 Screenshots

Landing	Dashboard
Login	Register
Repository	Repository (cont.)
Commits	Commit Diffs
Branches	Pull Requests
PR Detail	PR Detail (Files Changed)
PR Detail (Commits)	Profile
User Settings	Repo Settings

---

🚀 Getting Started

📖 Full documentation: originhub.nuricanozturk.com/docs [Only Documentation. Not deployed to cloud]

Option 1 — Docker Run (Manual)

docker network create originhub
docker run -d \
  --name originhub-postgres \
  --network originhub \
  -e POSTGRES_DB=originhub \
  -e POSTGRES_USER=admin \
  -e POSTGRES_PASSWORD=admin123 \
  postgres:17
docker run -d \
  --name originhub \
  --network originhub \
  -p 8080:8080 \
  -p 2222:2222 \
  -e SPRING_DATASOURCE_URL=jdbc:postgresql://originhub-postgres:5432/originhub \
  -e SPRING_DATASOURCE_USERNAME=admin \
  -e SPRING_DATASOURCE_PASSWORD=admin123 \
  -e ORIGINHUB_JWT_SECRET=your_secret_here \
  -e ORIGINHUB_GIT_REPO__ROOT=/data/repos \
  -e SPRING_PROFILES_ACTIVE=os \
  -v originhub-repos:/data/repos \
  repo.repsy.io/nuricanozturk/originhub/originhub-os:latest

---

Option 2 — Makefile

git clone https://github.com/nuricanozturk/originhub.git
cd originhub
make up

Edit the variables at the top of the Makefile before running — at minimum set JWT_SECRET. OAuth2 keys are optional.

Target	Description
make up	Create network, start DB and app
make down	Stop and remove containers
make start / make stop	Start or stop existing containers
make restart	Stop then start
make logs	Follow app logs
make logs-db	Follow database logs
make ps	List running containers
make clean	Remove containers and network (volumes kept)
make purge	Remove everything including repo data ⚠️

Environment Variables

Variable	Required	Default	Description
ORIGINHUB_JWT_SECRET	✅	—	Min 32-char secret for JWT signing
DB_USER		admin	PostgreSQL username
DB_PASSWORD		admin123	PostgreSQL password
ORIGINHUB_GIT_REPO__ROOT		/data/repos	Git repository storage path
ORIGINHUB_FRONTEND_BASE_URL		http://localhost:8080	Public base URL
OAUTH2_GOOGLE_CLIENT_ID		—	Google OAuth2 client ID
OAUTH2_GOOGLE_CLIENT_SECRET		—	Google OAuth2 client secret
OAUTH2_GITHUB_CLIENT_ID		—	GitHub OAuth2 client ID
OAUTH2_GITHUB_CLIENT_SECRET		—	GitHub OAuth2 client secret
OAUTH2_GITLAB_CLIENT_ID		—	GitLab OAuth2 client ID
OAUTH2_GITLAB_CLIENT_SECRET		—	GitLab OAuth2 client secret

---

🗺 Roadmap

OriginHub is under active development. Here's what's planned:

• HTTPS Git support
• Public repositories
• Fork and star repositories
• Actions — CI/CD (self-hosted runner)
• Team collaboration & organization support
• Project board (Kanban) integrated with repositories
• Webhooks
• Custom domain support
• Repository transfer (between accounts, and auto-import from GitHub / GitLab)
• Code snippets (Gist-like)
• Two-factor authentication (TOTP)
• Tags and releases
• Repsy package management integration
• Organization support

---

☕ Support

If OriginHub saves you time or you just want to say thanks, consider buying me a coffee. It keeps the project alive and the commits coming.

---