~/tools/onedev
OneDev
tool

OneDev

OneDev is an open source, self-hosted git server with built-in CI/CD — a GitHub, Bitbucket, and Azure DevOps alternative that bundles repositories, code search, pull requests, issue tracking, and a package registry into one lightweight Java application.

What is OneDev?

OneDev is an open source, self-hosted git server that packs code hosting, CI/CD, issue tracking, code review, and a package registry into a single lightweight application. It aims to be an all-in-one DevOps platform — an alternative to GitHub, Bitbucket, or Azure DevOps — that runs on modest hardware, with a standout code-search and symbol-navigation engine built in.

What is OneDev best for?

OneDev suits small-to-medium teams and individuals who want one self-hosted tool for the whole software lifecycle — repos, pipelines, and issues — without stitching together separate services or paying per seat. It’s a good fit if you value built-in code intelligence and a visual, no-code CI/CD editor, and want to keep resource usage low.

What can OneDev do?

  • Git hosting with pull requests, inline code review, and role-based branch protection and approval rules.
  • Built-in CI/CD with a GUI pipeline editor (no YAML required), matrix jobs, and executors for Docker containers, Kubernetes, and remote agent farms.
  • Code search and symbol navigation — language-aware “jump to definition” and regex search across a repository, closer to a web IDE than a typical forge.
  • Issue tracking with customizable workflows, automated Kanban boards, time tracking, and a service desk that turns emails into issues.
  • Package registry for Docker, npm, Maven, NuGet, PyPI, RubyGems, and Helm, wired into CI/CD.
  • AI integration — assign work to AI users to implement code, review pull requests, and troubleshoot failing CI/CD jobs.
  • Security scanning for dependency, binary, and container-image vulnerabilities (Enterprise).

Where does OneDev fall short?

Several features that GitHub or GitLab include out of the box are gated behind the paid Enterprise edition — cross-project code search, security scanning, Renovate dependency updates, audit logging, and high-availability/multi-server deployment all require a subscription. The free Community edition is single-server only, so you can’t scale it horizontally without paying.

It’s also a smaller project than GitLab or Gitea, so its community, third-party integrations, and documentation are thinner, and you’ll find fewer tutorials when you hit an edge case. Teams that only need lightweight git hosting without pipelines may find it heavier than a minimal forge like Gitea.

Is OneDev free?

Yes — the self-hosted Community edition is free and MIT-licensed, and it’s genuinely capable: git hosting, built-in CI/CD, the package registry, issue tracking, code review, and per-commit code search are all included with no user limit. The Enterprise edition costs $6 per user/month and adds high availability, cross-project code search, security scanning, audit logging, and priority support.

What does OneDev replace?

OneDev is a self-hosted stand-in for cloud DevOps suites like GitHub, Bitbucket, and Azure DevOps. Instead of paying per seat and keeping your code in a proprietary cloud, you run repositories, pipelines, issues, and packages on your own server. It’s also directly comparable to other self-hosted platforms like GitLab and Gitea.

FAQ

Is OneDev open source? Yes. The core (Community edition) is released under the permissive MIT license, and the source is on GitHub. Some advanced features are reserved for the commercial Enterprise edition.

Can I self-host OneDev for free? Yes. The Community edition is free to self-host with no per-user fee. It’s designed to be lightweight — the project notes a 1-core, 2 GB machine handles medium-sized projects.

What do I need to run OneDev? OneDev is a Java application that runs from a prebuilt package or the official Docker image, backed by a database (an embedded HSQLDB for trials, or MySQL/PostgreSQL for production). CI/CD builds need Docker or a Kubernetes/agent executor.

Is OneDev a good GitHub alternative? For teams wanting an all-in-one self-hosted platform, yes — it covers repos, CI/CD, issues, and packages in one lightweight app with strong built-in code search. Just note that scaling and some enterprise features require the paid tier.