OneDev — Self-Hosted Git Server with Built-In CI/CD and Kanban

What it is

OneDev is a self-hosted DevOps platform that combines Git repository hosting, CI/CD pipelines, issue tracking, and a Kanban board in a single Java binary. Unlike Gitea or GitLab, which require separate runners or external databases for full functionality, OneDev ships everything in one package with zero external dependencies.

OneDev is for small-to-medium teams that want a complete DevOps workflow without managing multiple services. It runs on any machine with a JVM and stores data in an embedded H2 database (with optional PostgreSQL or MySQL).

How it saves time or tokens

OneDev eliminates the overhead of integrating separate tools for source control, CI/CD, and project management. A single Docker command gives you a fully functional DevOps stack. No runner installation, no webhook configuration between services, no database setup.

The built-in CI/CD uses a YAML pipeline syntax with conditional steps, caching, and service containers. No external Jenkins or GitHub Actions needed.

How to use

1. Start OneDev with Docker:

docker run -d --name onedev \
  -p 6610:6610 \
  -v onedev-data:/opt/onedev \
  1dev/server

1. Open http://localhost:6610 and create your admin account.

1. Create a repository and add a .onedev-buildspec.yml for CI/CD:

version: 33
jobs:
  - name: Build
    steps:
      - !CommandStep
        name: Run Tests
        image: node:20
        commands:
          - npm install
          - npm test
    triggers:
      - !BranchUpdateTrigger {}

Example

A pipeline with build, test, and deploy stages:

version: 33
jobs:
  - name: CI
    steps:
      - !CheckoutStep
        name: Checkout
      - !CommandStep
        name: Build and Test
        image: golang:1.22
        commands:
          - go build ./...
          - go test ./...
      - !CommandStep
        name: Docker Build
        image: docker:latest
        commands:
          - docker build -t myapp:latest .
    triggers:
      - !BranchUpdateTrigger
        branches: main

Related on TokRepo

• AI tools for DevOps -- DevOps and CI/CD tools for development teams
• Self-hosted tools -- Self-hosted alternatives for development infrastructure

Common pitfalls

• Using the embedded H2 database for large teams (50+ users). H2 is fine for small teams but switch to PostgreSQL or MySQL for better concurrent access and backup tooling.
• Forgetting to set up backup for the onedev-data volume. All repositories, issues, and pipeline history live in this volume. Losing it means losing everything.
• Expecting GitHub/GitLab-compatible APIs. OneDev has its own REST API. Migration tools exist for importing repositories and issues, but webhook integrations need reconfiguration.