Distr
Distr is an open-source platform for shipping self-hosted software, letting teams start with Docker Compose proof-of-concepts and scale to Helm and air-gapped…
Platform availability
Available on 1 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
71/100 Good
- Maintained
- 100last commit 14 days ago
- Popular
- 621,245 GitHub stars
- Easy to install
- 251 install platform, install notes
- Light to run
- No data
- Security check
- 70no serious findings, 6 minor, CI, tests
Based on 4 of 5 factors.
Availability: platform listings confirmed today
- GitHub stars
- 1,245
- Open issues
- 22
- Last commit
- 2026-11-07
- Latest release
- 4.8.1
- License
- Apache-2.0
- Activity
- rising
Checked 14 days ago - source: GitHub (distr-sh/distr)
Resources & Compatibility
Requirements not published yet.
First-install notes
- Edit .env before starting Distr Make a distr folder, download the quickstart archive into it, then edit the .env settings file to set DATABASE_URL (where your database lives) and SECRET_KEY (a random encryption string). Then start it with Docker Compose (the tool that runs your containers) using docker compose up -d, because without those settings Distr cannot save data or run correctly. source
- Connect Docker agent with its tokens Use the one-line command from the docs to download and start the agent, replacing <distr-hub>, <targetId>, and <targetSecret> with your hub's values. Those values act like an ID and password; if they are wrong, the agent will start but not link to your hub. source
- Turn on MFA after first login In your user security settings, start MFA setup (multi-factor authentication), scan the QR code with an authenticator app, and enter the code it gives you. This adds a second check at login, so a stolen password alone won't let someone take over your Distr hub. source
Fetched 41 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Can Distr be self-hosted as an internal artifact registry?
Yes, Distr can be self-hosted in your own environment as an internal software distribution platform and artifact registry.
Can I simulate a Windows target environment with WSL2?
Yes, you can simulate a target environment on Windows with WSL2.
Where can I ask questions or collaborate with other Distr users?
Use the GitHub Discussions forum for distr-sh to discuss code, ask questions, and collaborate.
Answers sourced from distr.sh, distr.sh, github.com
Community
Collected 48 days ago - public community threads