Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/glasskube/distr
Software Distribution Platform - Distr is the easiest way to distribute enterprise software to customer-controlled or shared-responsibility environments.
https://github.com/glasskube/distr
angular cloud docker-compose glasskube go golang kubernetes on-prem on-premises software-distribution
Last synced: about 4 hours ago
JSON representation
Software Distribution Platform - Distr is the easiest way to distribute enterprise software to customer-controlled or shared-responsibility environments.
- Host: GitHub
- URL: https://github.com/glasskube/distr
- Owner: glasskube
- License: apache-2.0
- Created: 2024-11-19T13:14:16.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-02-04T15:47:18.000Z (2 days ago)
- Last Synced: 2025-02-04T16:26:53.837Z (2 days ago)
- Topics: angular, cloud, docker-compose, glasskube, go, golang, kubernetes, on-prem, on-premises, software-distribution
- Language: Go
- Homepage: https://distr.sh/docs
- Size: 1.91 MB
- Stars: 326
- Watchers: 1
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Distr
**Software Distribution Platform**
[](https://github.com/glasskube/distr)
[](https://opensource.org/licenses/Apache-2.0)
[](https://distr.sh/docs/?utm_source=github)
Distr is the easiest way to distribute enterprise software to customer-controlled or shared-responsibility environments.
Main features:
- View all deployments and connected agents via the **intuitive web UI**
- Let your customers control their deployments via the **white-label customer portal**
- Access the API using our [**rich SDK**](#distr-sdk)
- Fully open-source and [self-hostable](#self-hosting)
Check out the hosted version at https://app.distr.sh/register/
## About
Distr is an Open Source commercial software distribution platform designed for Independent Software Vendors (ISVs).
It supports ISVs in delivering their software solutions to end customers operating in complex, customer-controlled environments.
Use cases include:
- On-premises 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 overview
```mermaid
architecture-beta
group ctrl(cloud)[Your Cloud]
service db(database)[PostgreSQL] in ctrl
service hub(server)[Distr Hub] in ctrl
db:T -- B:hub
group customer(cloud)[Customer Cloud]
service app(server)[Your Application] in customer
service agent(internet)[Distr Agent] in customer
agent:L --> R:hub
app:T <-- B:agent
```
## Self-hosting
### Docker
The Distr Hub is distributed as a Docker image.
Check out [`deploy/docker`](deploy/docker) for our example deployment using Docker Compose.
To get started quickly, do the following:
```shell
mkdir distr && cd distr && curl -fsSL https://github.com/glasskube/distr/releases/download/1.0.4/deploy-docker.tar.bz2 | tar -jx
# make necessary changes to the .env file
docker-compose up -d
```
The full self-hosting documentation is at https://distr.sh/docs/self-hosting/self-hosting/
### Building from source
To build Distr Hub from source, first ensure that the following build dependencies are installed:
- NodeJS (Version 22)
- Go (Version 1.23)
- Docker (when building the Docker images)
We recommend that you use [mise](https://mise.jdx.dev/) to install these tools, but you do don't have to.
All build tasks can be found in the [`Makefile`](Makefile), for example:
```shell
# Build the control plane
make build
# Build all docker images
make build-docker
```
### Local development
To run the Distr Hub locally you need to clone the repository and run the following commands:
```shell
# Start the database and a mock SMTP server
docker-compose up -d
# Start Distr Hub
make run
```
Open your browser and navigate to [`http://localhost:8080/register`](http://localhost:8080/register) to register a user
and receive the E-Mail verification link via Mailpit on [`http://localhost:8025`](http://localhost:8025).
## Distr SDK
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](https://npmjs.org/):
```shell
npm install --save @glasskube/distr-sdk
```
The full SDK documentation is at https://distr.sh/docs/integrations/sdk/