# distr-sh/distr

The Open Source control plane for self-hosted, BYOC, and on-prem deployments. Everything you need to distribute applications to self-hosted customers out of the box. Supporting Docker Compose, Docker Swarm and Helm based applications.

Repository: https://github.com/distr-sh/distr
Canonical: https://ross.abutalabs.com/products/distr
Homepage: https://distr.sh/docs/
Language: Go
License: Apache-2.0
License Family: permissive
Topics: angular, cloud, go, golang, software-distribution, docker-compose, kubernetes, on-prem, on-premises, distr, byoc, docker-swarm, helm, self-hosted, alerts, license-management, logs, oberservability
Last push: 2026-09-02T16:33:06+00:00

## Health v2 (maintenance only)
Score: 85/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 100, release rhythm 88, longevity 46
- inputs: {"age_days": 652, "days_push": 0, "days_rel": 1, "gap_med": 2, "n_releases_24m": 154}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1219, forks 50 (observed 2026-09-03T02:15:11.310007+00:00)

## What it is
Distr is an open-source software distribution platform (control plane) for delivering applications to self-hosted, BYOC, on-premises, air-gapped, and edge customer environments. It combines a vendor hub with deployment agents for Docker Compose, Docker Swarm, and Helm/Kubernetes, a white-label customer portal, an OCI-compliant artifact registry, and license management.

## Use cases
- distribute my docker compose app to self-hosted customers
- manage BYOC deployments across customer cloud accounts
- run an on-prem software distribution control plane
- host a private OCI registry with per-customer entitlements
- monitor and collect logs from deployments in customer environments
- issue license keys and control which versions customers can deploy
- manage a fleet of edge deployments from one dashboard
- give customers a white-labeled portal to manage their deployments

## When to choose
- you ship software to customers who run it in their own infrastructure (on-prem, VPC, air-gapped, edge)
- you need deployment automation, observability, and a customer portal out of the box
- you want an integrated OCI registry with access control and download analytics
- you need license/entitlement management tied to artifact distribution

## When to avoid
- you only deploy to cloud infrastructure you fully control - standard CI/CD suffices
- you need a general-purpose PaaS or app hosting platform rather than a distribution control plane
- you require license management or alerts but cannot use the paid Pro features
- your applications are not containerized (Docker Compose, Swarm, or Helm based)

## Facets
- artifact type: application
- maturity: active
- function: deployment, container-orchestration, monitoring, alerting, logging, secrets-management, api-gateway, self-hosted, developer-tools
- domain: self-hosted, cloud-computing, developer-tools, infrastructure-as-code
- platform: go, self-hosted
- tags: software-distribution, byoc, on-prem, helm, docker-compose, docker-swarm, oci-registry, license-management, white-label, customer-portal, edge-deployments, air-gapped, vendor-portal, observability, devops, containers, docker, kubernetes, linux, web-server

## Member repositories
- distr-sh/distr (main) score 85

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:11.310007+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:17:03.519675+00:00, confidence not recorded.
  - readme: https://github.com/distr-sh/distr (fetched 2026-09-03T02:15:11.310007+00:00, sha b94c49fa3572)
  - homepage: https://distr.sh/docs/ (fetched 2026-08-29T12:24:44.812562+00:00, sha 4bc9115ba153)
  - site_page: https://distr.sh/docs/agents (fetched 2026-08-29T12:24:44.821450+00:00, sha 3ca6486ce5b2)
  - site_page: https://distr.sh/docs/platform/customer-portal (fetched 2026-08-29T12:24:44.823360+00:00, sha 4479f7cb16ff)
  - site_page: https://distr.sh/docs/registry (fetched 2026-08-29T12:24:44.825031+00:00, sha 6bd5b8464f76)
  - site_page: https://distr.sh/docs/platform/license-management (fetched 2026-08-29T12:24:44.826694+00:00, sha 1b46d69bb67c)
  - site_page: https://distr.sh/docs/agents/alerts (fetched 2026-08-29T12:24:44.828445+00:00, sha 98d70f968eb7)
  - site_page: https://distr.sh/docs/agents/logs-and-metrics (fetched 2026-08-29T12:24:44.830054+00:00, sha bde5026e3430)
  - site_page: https://distr.sh/docs/platform/kubernetes-compatibility-matrix (fetched 2026-08-29T12:24:44.832031+00:00, sha ee223d2efdd2)
  - site_page: https://distr.sh/docs/agents/preflight-checks (fetched 2026-08-29T12:24:44.834772+00:00, sha 768e728fe7e7)
- Data as of 2026-08-30T08:39:29.467469+00:00.