- Centralized Management: View & manage all deployments, artifacts, connected agents, self-managed & BYOC customers via the intuitive web UI
- Deployment Automation: Optional prebuilt Helm and Docker agents manage deployments, collect logs and metrics, and allow remote troubleshooting.
- White-label customer portal: Let your customers control their deployments or download your artifacts
- License Management: Distribute specific versions of your application to specific customers
- Container registry: Distribute OCI-compatible artifacts (Docker images, Helm charts, Terraform modules) with built-in granular access control and analytics.
- Access the API using our rich SDK
- Fully Open Source and self-hostable
Check out the hosted version at https://distr.sh/get-started/.
Distr is an Open Source software distribution platform that provides a ready-to-use setup with prebuilt components to help software and AI companies distribute applications to customers in complex, self-managed environments.
Use cases include:
- On-premises, VPC and self-managed software deployments
- Bring Your Own Cloud (BYOC) automation
- Edge & Fleet management
Read more about Distr and our use cases at https://distr.sh/docs/getting-started/about/
architecture-beta
group ctrl(cloud)[Distr Saas or Your Cloud]
service hub(server)[Distr Hub] in ctrl
service db(database)[PostgreSQL] in ctrl
service oci(database)[Distr OCI Registry] in ctrl
service s3(disk)[Object Storage] in ctrl
oci:R -- L:hub
db:T -- B:hub
oci:B -- T:s3
junction customerjunction
hub:R <-- L:customerjunction
customerjunction:T -- B:agent
customerjunction:B -- T:client
group agentcustomer(cloud)[Customer Cloud]
service agent(internet)[Distr Agent] in agentcustomer
service app(server)[Your Application] in agentcustomer
agent:L --> R:app
group ocicustomer(cloud)[Fully self managed customer]
service client(internet)[OCI client] in ocicustomer
In case you get stuck, have questions, or need help, we're happy to support you, drop by our Discord.
The Distr Hub is distributed as a Docker image via ghcr.io.
Check out deploy/docker for our example deployment using Docker Compose.
To get started quickly, do the following:
mkdir distr && cd distr && curl -fsSL https://github.com/distr-sh/distr/releases/latest/download/deploy-docker.tar.bz2 | tar -jx
# make necessary changes to the .env file
docker-compose up -dDistr is also available as a Helm chart distributed via ghcr.io.
Check out deploy/charts/distr for our Helm Chart source code.
To install Distr in Kubernetes, simply run:
helm upgrade --install --wait --namespace distr --create-namespace \
distr oci://ghcr.io/distr-sh/charts/distr \
--set postgresql.enabled=true --set minio.enabled=trueFor a quick testing setup, you don't have to modify the values. However, if you intend to use distr in production, please revisit all available configuration values and adapt them accordingly. You can find them in the reference values.yaml file.
Register your first account at http://localhost:8080/register
The full self-hosting documentation is at https://distr.sh/docs/self-hosting/self-hosting/
Using Distr agents on macOS? Follow the guide to get started.
To build Distr Hub from source, first ensure that the following build dependencies are installed:
- NodeJS (Version 22)
- Go (Version 1.25)
- Docker (when building the Docker images)
We recommend that you use mise to install these tools, but you do don't have to.
All build tasks can be found in the mise.toml file, for example:
# Build the control plane
mise run build:hub
# Build all docker images
mise run "docker-build:**"Check out our contributing guidelines.
Interact with Distr directly from your application code using our first-party SDK. The Distr SDK is currently available for JavaScript only, but more languages and frameworks are on the roadmap. Let us know what you would like to see!
You can install the Distr SDK for JavaScript from npmjs.org:
npm install --save @distr-sh/distr-sdkThe full SDK documentation is at https://distr.sh/docs/integrations/sdk/
Use the Distr MCP server to connect your deployments, applications, artifacts and licenses to agentic workflows, or to interact with the Distr platform in LLM Clients.
The Distr MCP server is hosted on HyprMCP (hyprmcp.com & hyprmcp/jetski).
It can either be used as a Remote MCP server via the streamable HTTP protocol or used locally via stdio.
Note
The Distr MCP server requires authentication via a personal access token.
Configure a personal access token (PAT)
in an Authorization header when calling the MCP server.
Header name: Authorization
Header value: AccessToken distr-bc46...
Example configuration for Claude Code would look like:
claude mcp add --transport http distr https://glasskube.hyprmcp.cloud/distr/mcp --header "Authorization: AccessToken distr-bc46..."The full MCP Server documentation is at https://distr.sh/docs/integrations/mcp/