The full guide
Last verified 2026-10-30
Links checked 2026-10-30 · All links answer
01What it is and who is there
awesome-selfhosted is a large, curated list of free software that people can run on their own servers. Readers are self-hosters, home-lab users and system administrators looking for apps to install. It has strict rules on what it accepts, so a listing is a sign of quality to that audience.
02Cost and what you actually pay for
It is free. The cost is meeting the list's requirements and keeping your project in good shape after it is listed.
03Is it right for you?
It fits open-source apps that people can install and run themselves, with a license the list accepts. It fits poorly for hosted SaaS with no self-host option, and for very new projects. Read the requirements before you build your hopes on it.
04Before you start
- Read the list's contributing guidelines in full. They cover license, project maturity, and how entries are written.
- Make sure the project has clear install docs, a license file and recent releases.
- Prepare a short, factual description in the list's style.
05Step-by-step: how to distribute here
- Check that your project meets every requirement in the contributing guide.
- Find the right category in the list.
- Open a pull request following the exact entry format.
- Answer maintainer questions and make requested changes.
- Once merged, keep releases going. Inactive projects may be removed under the list's rules.
06What to post or submit
Entry, in the list's format:
- [Project](https://[project site]) - [What it does, briefly]. ([Demo](https://[demo]), [Source Code](https://[repo])) `[License]` `[Language or platform]`Check the current format in the contributing guide, since it can change.
07Common mistakes and do-nots
- Do not submit hosted-only products.
- Do not submit a project with an unclear or unaccepted license.
- Do not break the entry format.
- Do not resubmit after a decline without fixing the reason.
08How to measure it
- Track referrals from github.com to your repo and site.
- Track stars and install docs visits after the merge.
- A realistic test: compare traffic in the month before and after the merge.
09Time budget
- Before: 2 to 4 hours to meet requirements and prepare the entry.
- During: 30 minutes for the pull request.
- After: ongoing release upkeep.
10Pair it with
- GitHub awesome lists — other topic lists.
- Docker Hub — an easy install route for self-hosters.
- OpenAlternative — open-source alternatives to SaaS.
- Hacker News (Show HN) — a launch for technical users.
11Sources
- awesome-selfhosted: https://github.com/awesome-selfhosted/awesome-selfhosted