Build
Connect & operate
Design & teams
Start hereScope a build in one callBring a spec, a wireframe, or a paragraph. You leave with an architecture, a timeline, and a number.Book a scoping call
AI software
LLM & data systems
Vibe coding
Ready to ship?Put AI where the work isAgents, RAG, and private LLMs wired into the systems your team already uses — not a chatbot bolted to a homepage.Discuss an AI project
Domain firstWe learn your workflow before we model itRegulated, operational, or high-volume — the constraints belong in the schema, not in a training doc.Talk about your domain
Plan smarterEstimate before you commitCost ranges, scope templates, and the questions we ask in discovery — free, no form.Open the cost calculator
Real conversationsTalk with a technical leadNo SDR, no discovery gauntlet. The person on the call is the one who scopes the build.Book a call
Open-Source DevOps · distr-sh

distr

Distr is an open-source control plane for distributing applications to self-hosted, on-premise, and BYOC customer environments. It provides centralized management, deployment automation, license control, and a container registry—all self-hostable or cloud-hosted.

Source: GitHub — github.com/distr-sh/distr
1.2k
GitHub stars
47
Forks
Go
Primary language
Apache-2.0
License (OSI-approved)

Key facts

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

FieldValue
Repositorydistr-sh/distr
Ownerdistr-sh
Primary languageGo
LicenseApache-2.0 — OSI-approved
Stars1.2k
Forks47
Open issues16
Latest release2.25.1 (2026-07-07)
Last updated2026-07-08
Sourcehttps://github.com/distr-sh/distr

What distr is

Written in Go, Distr orchestrates Docker Compose, Docker Swarm, and Helm-based deployments via prebuilt agents that handle logs, metrics, and remote troubleshooting. It includes a PostgreSQL-backed hub, OCI-compatible registry, object storage integration, and REST API with JavaScript SDK support.

Quickstart

Get the distr source

Clone the repository and explore it locally.

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

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

Best use cases

On-Premises & Self-Managed Software Distribution

Manage deployments across customer-controlled infrastructure with centralized oversight, version control, and license enforcement from a single pane of glass.

BYOC (Bring Your Own Cloud) Automation

Deploy and manage multi-tenant applications in customer VPCs or cloud accounts with agent-based orchestration and automated artifact distribution.

Edge & Fleet Management

Distribute OCI artifacts (Docker images, Helm charts, Terraform modules) to geographically distributed or air-gapped environments with granular access control and analytics.

Implementation considerations

  • PostgreSQL and object storage (S3-compatible) are required infrastructure; plan for HA/backup if production-critical.
  • Agent deployment to customer infrastructure requires network connectivity and appropriate firewall/security group rules; air-gapped deployments need artifact pre-positioning.
  • License management and white-label portal features must be configured upfront; integration with existing billing/entitlement systems requires custom API work.
  • SDK is JavaScript-only; backend integrations via REST API may require custom middleware or glue code.
  • Self-hosted deployments require monitoring, patching, and PostgreSQL maintenance; hosted version shifts operational burden to vendor.

When to avoid it — and what to weigh

  • Simple SaaS-only deployments — If your customers run fully managed cloud infrastructure, standard CI/CD pipelines may be more practical than a distribution control plane.
  • Minimal operational overhead required — Self-hosting Distr requires PostgreSQL, object storage, and container orchestration—unsuitable if you want zero infrastructure management.
  • Non-containerized application stack — Distr is tightly coupled to Docker Compose, Swarm, and Helm; legacy VM or bare-metal deployments are not primary targets.
  • Enterprise support and SLA guarantees needed immediately — Project is young (created Nov 2024); enterprise support availability and track record are Unknown.

License & commercial use

Licensed under Apache License 2.0, a permissive open-source license allowing commercial use, modification, and distribution with attribution and liability disclaimer.

Apache 2.0 permits commercial use and closed-source derivatives. However, project maturity is early (created Nov 2024, 1196 stars, 16 open issues); no explicit commercial support tiers or SLAs are documented in the repository. A hosted version and enterprise plans are referenced (https://distr.sh/pricing/) but terms are external. Requires review before production commitments.

DEV.co evaluation signals

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

SignalAssessment
MaintenanceActive
DocumentationAdequate
License clarityClear
Deployment complexityHigh
DEV.co fitGood
Assessment confidenceMedium
Security considerations

Distr handles artifact distribution and customer deployment orchestration; security implications include: (1) Container registry access control granularity—review role-based policies; (2) Agent-to-hub communication encryption and authentication—check TLS enforcement and API key rotation policies; (3) PostgreSQL and object storage hardening responsibility (self-hosted) or vendor responsibility (SaaS); (4) License enforcement and entitlement logic—audit anti-tampering measures; (5) Multi-tenancy isolation if shared registry used. No security audit, CVE history, or threat model provided in repository.

Alternatives to consider

ArgoCD + Sealed Secrets

Kubernetes-native GitOps for declarative deployments; lighter operational footprint but requires Kubernetes on all customer sites.

Spacelift or Env0

IaC-focused platforms supporting Terraform/Helm with multi-tenancy and policy engines; mature SaaS with enterprise support but higher licensing costs.

Pulumi Automation API

Programmatic infrastructure orchestration with custom control planes; requires engineering effort but offers fine-grained deployment logic.

Software development agency

Build on distr with DEV.co software developers

Start with a self-hosted Docker deployment (10 min setup) or review the GitHub repo discussions. For enterprise support questions, visit https://distr.sh/pricing/ or contact the team.

Talk to DEV.co

Related open-source tools

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

distr FAQ

Can I use Distr for non-containerized deployments?
Not as a primary use case. Distr is designed for Docker Compose, Docker Swarm, and Helm. Legacy VMs or bare-metal require workarounds or custom agents.
Is the JavaScript SDK the only programmatic interface?
No. A comprehensive REST API is available. JavaScript SDK is provided for convenience; other languages must use REST API directly or build custom wrappers.
What happens if I self-host and then want to migrate to the Distr SaaS?
Unknown. The README does not document migration paths or data portability. Contact https://github.com/distr-sh/distr/discussions or the vendor before committing.
Does Distr support air-gapped (offline) deployments?
Not explicitly stated. OCI clients can pull from a self-hosted registry, but agent connectivity and automatic updates in offline environments require manual artifact pre-positioning—verify with the team.

Build it with a software development company

DEV.co is a software development company delivering production systems to teams building on open source. Our engineers design, integrate, and ship across web, APIs, AI, data, and cloud. If distr is part of your open-source devops roadmap, we can implement, customize, migrate, and maintain it.

Ready to evaluate Distr for your deployment workflow?

Start with a self-hosted Docker deployment (10 min setup) or review the GitHub repo discussions. For enterprise support questions, visit https://distr.sh/pricing/ or contact the team.