40aa6d9d1a
Tidy the repo root (README + LICENSE stay there per convention; everything else moves): - CONTRIBUTING.md, PROMISE.md, FOOTPRINT.md -> docs/ (alongside USER.md/DEVELOPMENT.md) - update the references: README links, the website site.json raw URLs, init.sh's 'see FOOTPRINT.md' comments -> docs/FOOTPRINT.md; drop the now-redundant CONTRIBUTING.md export-ignore (docs/ is already export-ignored). Refresh FOOTPRINT.md: it claimed 'everything lives under /docker', which is no longer true. Now describes the three relocatable roots (system/containers/backups) and makes explicit that the roots + manager name are baked into the helpers/unit/ wrapper at install (the privilege boundary) while this out-of-root footprint stays fixed by design. Uninstall sketch + sudoers/unit rows updated for the configurable manager. CONTRIBUTING/PROMISE were already current — left as-is. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> Signed-off-by: librelad <librelad@digitalangels.vip>
80 lines
3.2 KiB
Markdown
Executable File
80 lines
3.2 KiB
Markdown
Executable File
# LibrePortal
|
|
|
|
**Your own private corner of the internet — free, open, and yours.**
|
|
|
|
LibrePortal is a self-hosted platform for running the apps you rely on, on
|
|
your own server: one-click installs, a reverse proxy with automatic SSL,
|
|
rootless Docker, optional VPN routing, and a clean web dashboard to manage
|
|
it all.
|
|
|
|
> ⚠️ **v0.1.0 — early days.** Expect rough edges while things settle.
|
|
|
|
## Why LibrePortal
|
|
|
|
Too many services today treat your data as theirs to take — quietly
|
|
overstepping boundaries that should never have been crossed. LibrePortal grew
|
|
out of frustration with that: it's a way to run the apps you depend on on
|
|
your own server, where your data stays yours. Privacy here isn't a feature to
|
|
toggle — it's the whole point.
|
|
|
|
## Free & open — forever
|
|
|
|
The entire platform is **free software under the [GNU AGPLv3](LICENSE)**.
|
|
Self-host it and you get **everything** — every feature, no paywalls, no
|
|
telemetry. See [our Promise](docs/PROMISE.md) for exactly what that means.
|
|
|
|
## What you get
|
|
|
|
- 📦 One-click self-hosted apps (Nextcloud, Vaultwarden, Jellyfin, Gitea, …)
|
|
- 🔀 Traefik reverse proxy + automatic Let's Encrypt SSL
|
|
- 🔒 Rootless Docker, CrowdSec, sane security defaults
|
|
- 🛡️ Optional VPN routing (gluetun) for any app
|
|
- 🖥️ A web dashboard to install, configure, back up, and monitor everything
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
curl -fsSL https://get.libreportal.org/install.sh | sudo bash
|
|
```
|
|
|
|
This installs a versioned, checksum-verified release (Debian/Ubuntu, root). Put
|
|
data on separate disks with `--system-dir=` / `--containers-dir=` / `--backups-dir=`.
|
|
|
|
> The `get.libreportal.org` host is still being set up — until it's live, build a
|
|
> release and install from it locally (see the docs below).
|
|
|
|
## Documentation
|
|
|
|
- **[docs/USER.md](docs/USER.md)** — install, place data on separate disks/drives,
|
|
update, back up, uninstall.
|
|
- **[docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)** — run a dev copy, cut stable/edge
|
|
releases, and test them before publishing.
|
|
|
|
## LibrePortal Connect (optional)
|
|
|
|
Self-hosting is free and complete. If you'd rather not fiddle with the tricky
|
|
parts — like reaching your server from your phone, or keeping off-site backups
|
|
— LibrePortal Connect will handle them for you. Here's the catch that makes us
|
|
different: we work like a **courier carrying a sealed box.** We move your data
|
|
between your devices and store backup copies, but it stays locked and *you*
|
|
hold the only key — we can't open it, and we never run your apps for you.
|
|
**Everything we offer, you can also set up yourself for free.**
|
|
[Our Promise](docs/PROMISE.md) spells out exactly where that line sits.
|
|
|
|
## Contributing
|
|
|
|
PRs welcome — see [CONTRIBUTING.md](docs/CONTRIBUTING.md). We use a lightweight
|
|
DCO sign-off (`git commit -s`), no CLA.
|
|
|
|
## Acknowledgments
|
|
|
|
LibrePortal has been built from scratch since 2023. Its spark of inspiration
|
|
was a small installer script from Brian McGonagill (`OpenSourceIsAwesome`):
|
|
[gitlab.com/bmcgonag/docker_installs](https://gitlab.com/bmcgonag/docker_installs).
|
|
From that seed it grew start to finish — refined, extended, and refactored
|
|
into the platform it is today.
|
|
|
|
## License
|
|
|
|
[GNU AGPLv3](LICENSE). What's open stays open.
|