Self-host harness
v2.28.2Open DevOps platform with Git hosting, pipelines, registries
docker run -d -p 3000:3000 -p 3022:3022 -v /var/run/docker.sock:/var/run/docker.sock -v /tmp/harness:/data --name harness --restart always harness/harness- Stars
- 38 922
- Port
- 3000 (HTTP port serving the web UI, REST API and Git/registry endpoints)
harness/harnessWhat is harness?
Harness Open Source is the open-source, self-hostable half of Harness's developer platform: an Apache-2.0 project that combines a Git hosting front end with pull requests, code reviews, protected branches and webhook-driven builds, YAML pipelines, pre-configured cloud development environments called Gitspaces, and artifact registries for Docker images, Helm charts and generic packages. It grew out of Drone CI, and the team keeps a snapshot of Drone on a feature branch while it works toward pipeline parity. A single harness/harness container serves the web UI, REST API and Git endpoints on port 3000 and exposes 3022 for Git traffic; pipelines run inside Docker containers, so the Docker socket is mounted into the instance and data is kept on a bind-mounted volume. SQLite is used by default and Postgres can be swapped in through GITNESS_DATABASE_DRIVER and GITNESS_DATABASE_DATASOURCE. Sign-up is open to anyone reaching the instance unless GITNESS_USER_SIGNUP_ENABLED is turned off, and secrets are stored in plaintext unless you supply an encryption secret.
harness alternatives
docker-gha-runnerDocker-based self-hosted GitHub Actions runner with stateless execution, platform emulation, and Docker-in-Docker support.Comparedocker-gha-runner with harness
PipewrightA self-hosted CI/CD platform that unifies build pipelines, server deployment, and container management in a single Go binary.ComparePipewright with harness
GogsA lightweight, open-source, self-hosted Git service written in Go: repos, issues, pull requests, wikis and LDAP login, run from one binary or a Docker image.CompareGogs with harness
swiftwaveSwiftWave: self-hosted open source PaaS for deploying apps on any server. Alternative to Heroku/Netlify/Render with 1GB RAM min and integrated app store.Compareswiftwave with harness
GitLab-CESelf-hosted, open-source DevOps platform for Git repositories, merge requests, CI/CD pipelines, issue boards and wikis, with free CE and paid Premium/Ultimate tiers.CompareGitLab-CE with harness
GitWitGitWit is a self-hosted, open-source AI coding platform with a browser-based IDE, live preview, AI chat, and support for Anthropic, OpenAI, and AWS Bedrock.CompareGitWit with harness
openrunA self-hosted GitOps platform that deploys web apps to Docker or Kubernetes using declarative config, with built-in SSO, RBAC, and database bindings.Compareopenrun with harness
DiggerOpen-source Terraform CI/CD that plans and applies inside your existing CI, with PR comments, drift detection, OPA policies and a self-hosted orchestrator backend.CompareDigger with harness
Should you self-host harness?
harness scores 79/100 on selfhost.directory (how scoring works) and ranks #3 of 28 in CI/CD. It has 38 922 GitHub stars, +394 in the last 30 days.
It shipped 6 stable releases in the past year. The latest, v2.28.2, came out on 20 April 2026. New versions land roughly every 2 weeks.
Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.
Its closest alternative on selfhost.directory is jenkins (83/100, 26 780 stars). It scores higher overall, so compare the two before you pick. See harness vs jenkins side by side.
Features
- Artifact Registry
- CI/CD Pipelines
- CLIREADME calls the CLI tools "VERY basic" and for development use; server must be running.
- Cloud development environments
- Code Review
- Git code hosting
- Notifications and alerts
- Pipeline templates
- Protected branches
- Pull Requests
- REST API
- Secret scanning
- Upstream repository proxy
- User Management
- Webhooks
harness README
Harness Open Source is an open source development platform packed with the power of code hosting, automated DevOps pipelines, hosted development environments (Gitspaces), and artifact registries.
Harness Open source is an open source development platform packed with the power of code hosting, automated DevOps pipelines, Gitspaces, and artifact registries.
FAQ
How can I handle SSL errors when using the default clone task?
Set clone.insecure=true to bypass the errors, or configure the Docker environment to trust the required certificates instead.
Can I override the default cloning task image used by Harness?
Yes — make the replacement image available in the local Docker cache or behind a registry mirror, and Harness will use the cached image.
How can I avoid Harness from pulling the :latest tag of an image?
Reference an explicit version tag instead of :latest, and add pull: if-not-exists to the pipeline step so an image is only pulled when it is not already present locally.
What images are required to run Harness Open Source offline?
Only the drone/git clone image is essential for pipelines; plugin images are optional extras.
How can I run Harness Open Source in an offline environment without internet access?
Pre-pull the images you need on a connected machine, export them with docker save and load them into the offline Docker cache, or point the Docker daemon at a local registry mirror that Harness can pull through.
More in CI/CD
inertiaInertia is an open-source, self-hosted continuous deployment platform for small teams with a CLI and daemon that automates Docker deployments to any VPS via webhooks.
jenkinsSelf-hosted open-source automation server for CI/CD: Pipeline (Jenkinsfile) builds, 2300+ plugins, distributed agents; runs via WAR, Docker, packages.
KeployOpen-source record-and-replay testing tool that turns live API, database and queue traffic into runnable tests and mocks; self-hosted via a CLI agent.
krakenKraken CI is a self-hosted, open-source CI/CD system for massive-scale testing with hardware testing support, cloud autoscaling, and detailed test analytics.
KuberoOpen-source, self-hosted PaaS for Kubernetes: deploy containers or source with 160+ app templates, CI/CD pipelines and GitOps review apps, run by a UI plus operator.
Mend Renovate CLIMend Renovate CLI auto-updates dependencies across 90+ package managers on GitHub, GitLab, Bitbucket, Azure DevOps. Self-hosted, open-source, replaces manual maintenance.
mortiseMortise brings Railway-style git-push deployments to your own Kubernetes cluster. Open-source, self-hosted, handles builds, TLS, domains, and preview environments.
myshoesmyshoes is an open-source, self-hosted daemon that manages auto-scaling GitHub Actions runners on your own cloud infrastructure.
OneDevOneDev is a powerful and simple DevOps platform that integrates Git server, Kanban, CI/CD, and package registries into a seamless experience.
OpenshipSelf-hosted open-source PaaS: hand it a repo, a folder or an artifact and it detects your stack, builds it, then serves it on your domain with free certificates.
OrbiOrbi is an open-source, self-hosted software delivery system that turns labeled GitHub Issues into independently reviewed, merged PRs and tagged releases using AI agents.
php-censorPHP Censor is an open-source, self-hosted CI server for PHP. Builds from GitHub, GitLab, Bitbucket, runs tests, checks code quality. Deploys via Composer or Docker.


0 comments