DEV.co
Open-Source DevOps · theonedev

onedev

OneDev is a self-hosted, all-in-one development platform combining Git hosting, CI/CD pipelines, Kanban boards, and package management in a single Java application. It emphasizes low resource overhead, built-in AI capabilities, and deep cross-feature integration without requiring external tools.

Source: GitHub — github.com/theonedev/onedev
15.1k
GitHub stars
965
Forks
Java
Primary language
MIT
License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
Repositorytheonedev/onedev
Ownertheonedev
Primary languageJava
LicenseMIT — OSI-approved
Stars15.1k
Forks965
Open issues0
Latest releasev16.0.2 (2026-07-04)
Last updated2026-07-08
Sourcehttps://github.com/theonedev/onedev

What onedev is

Java-based monolithic application offering Git server, containerized CI/CD execution (Docker, Kubernetes, agents), templated workflow definitions, integrated package registries, and AI-assisted code review and DevOps intelligence. Designed for resource efficiency and cluster deployment via replication or horizontal distribution.

Quickstart

Get the onedev source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/theonedev/onedev.gitcd onedev# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Small-to-medium teams seeking unified platform

Consolidate Git, CI/CD, issue tracking, and packages in one self-hosted system with minimal infrastructure; avoids managing separate GitLab/GitHub + Jenkins + Artifactory stacks.

Resource-constrained environments

Deploy on 1 CPU, 2GB RAM for medium projects. Reduces operational overhead compared to larger monoliths or Kubernetes-native alternatives.

AI-assisted development workflows

Leverage built-in natural language queries, PR review automation, code explanation, and autonomous AI agent integration (via Skills/CLI) for developer productivity.

Implementation considerations

  • Verify Java runtime and database requirements (PostgreSQL recommended per docs); test resource footprint in target environment before production rollout.
  • Plan for secrets management (API keys, credentials) in CI/CD jobs; review OneDev's credential storage and rotation model against compliance needs.
  • Evaluate AI feature dependencies: built-in AI requires API endpoint configuration; ensure network/firewall rules allow outbound calls if applicable.
  • Assess current Git workflow and tooling migration effort; OneDev's query language, Kanban rules, and CI/CD DSL require team training and workflow redesign.
  • Test CI/CD executor modes (Docker, Kubernetes, agent) in isolated environment; confirm performance and security posture for your workload types.

When to avoid it — and what to weigh

  • Large enterprise with strict tool segregation — Organizations requiring specialized, best-of-breed tools (dedicated Git, CI, artifact management) may find monolithic integration inflexible or operationally misaligned.
  • Cloud-native, serverless-first architecture — OneDev is stateful and self-hosted; not designed for ephemeral, auto-scaling cloud-native deployments without significant customization.
  • Mandatory third-party SaaS compliance — If regulatory or corporate policy mandates GitHub/GitLab SaaS with specific compliance certifications, self-hosted OneDev will not satisfy those constraints.
  • Highly heterogeneous CI/CD pipeline landscape — Teams with deeply customized, legacy, or non-standard CI/CD frameworks may struggle to migrate or consolidate into OneDev's templated, GUI-driven job model.

License & commercial use

MIT License (SPDX: MIT). Permissive open-source license allowing unrestricted commercial use, modification, and distribution, provided the license notice is retained.

MIT is a permissive OSI-approved license. Commercial use, modification, and distribution are permitted without restriction, provided the MIT license notice is included. No warranty is offered. For production use, review OneDev's support and SLA terms independently; the license itself places no restrictions on commercial deployment.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

SignalAssessment
MaintenanceActive
DocumentationStrong
License clarityClear
Deployment complexityModerate
DEV.co fitGood
Assessment confidenceHigh
Security considerations

OneDev is self-hosted, shifting security responsibility to operators: database encryption, TLS configuration, firewall rules, credential storage, and backup integrity must be enforced. Built-in AI features introduce external API calls—review endpoint whitelisting and data residency requirements. Kubernetes executor mode depends on cluster RBAC and network policies. No formal security audit, threat model, or vulnerability disclosure process details provided; requires independent review.

Alternatives to consider

GitLab (self-hosted or SaaS)

Full-featured alternative with broader ecosystem, larger community, and dedicated support tiers; higher resource overhead and tool complexity.

Gitea + external CI/CD (Jenkins, Tekton)

Lightweight Git server paired with best-of-breed CI/CD; offers flexibility and modularity at cost of operational fragmentation.

GitHub Enterprise Server + Actions

Industry-standard with mature ecosystem, largest community, but higher cost and resource requirements; SaaS-only for most teams.

Software development agency

Build on onedev with DEV.co software developers

OneDev combines Git, CI/CD, and project management in a single, resource-efficient application. Start with our live demo, review deployment requirements, and evaluate integration with your team's workflows.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

Related on DEV.co

Explore the category and the services that help you build with it.

onedev FAQ

Can OneDev run in a Kubernetes cluster?
Yes. OneDev supports Kubernetes as a CI/CD executor mode for scaling jobs. OneDev itself can be deployed on Kubernetes, though it is stateful and requires persistent storage and database backing.
Does OneDev require external CI/CD runners or agents?
No. Jobs can run in-container or on bare metal out-of-box. For scale, use Kubernetes executor or agent pools; external runners (e.g., GitHub Actions) are not required.
What happens if I migrate from GitLab to OneDev?
Git repositories can be imported; issues, CI/CD definitions, and Kanban state may require manual migration or custom scripts. Documentation covers typical workflows; evaluate effort for your project count and complexity.
Is the built-in AI free or does it require a subscription?
Data provided does not specify pricing or licensing for AI features. Documentation links mention 'built-in AI'; independent review of AI feature terms and external dependencies required.

Custom software development services

Adopting onedev is usually one piece of a larger software development effort. As a software development agency, DEV.co provides software development services and web development expertise — pairing senior software developers and web developers with your team to design, build, and operate open-source devops software in production.

Ready to consolidate your DevOps stack?

OneDev combines Git, CI/CD, and project management in a single, resource-efficient application. Start with our live demo, review deployment requirements, and evaluate integration with your team's workflows.