selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

harness logo

Self-host harness

v2.28.2

Open DevOps platform with Git hosting, pipelines, registries

ReleaseOpen SourceApache-2.0
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
Updated7 months ago
LanguageGo
Setup difficultyEasy
Stars
38 922
Port
3000 (HTTP port serving the web UI, REST API and Git/registry endpoints)
Docker
harness/harness
harness screenshot 1harness screenshot 2

What 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

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

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.

Overview

Harness Open source is an open source development platform packed with the power of code hosting, automated DevOps pipelines, Gitspaces, and artifact registries.

Running Harness locally

How to install harness

Install harness with Docker

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

Instance data lives under /data in a volume; a bind mount or named volume is recommended.

How to configure harness

  • GITNESS_CI_CONTAINER_NETWORKSComma separated list of Docker networks attached to every pipeline step.
  • GITNESS_CI_PARALLEL_WORKERS2Number of parallel pipeline workers; each worker runs a single pipeline.
  • GITNESS_DATABASE_DATASOURCEDatabase connection string (SQLite file by default, Postgres URI or key-value pair).
  • GITNESS_DATABASE_DRIVERsqlite3Database driver name; set to postgres to use your own Postgres database.

    values: sqlite3, postgres

  • GITNESS_DEBUGfalseSet DEBUG log level.

    values: true, false

harness releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

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

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…