# LibrePortal docs

Sorted by audience. Start with **guide/** if you're running LibrePortal,
**contributing/** if you're hacking on it.

## guide/ — using LibrePortal
- [install-and-use.md](guide/install-and-use.md) — install, place data on separate disks, update, back up, uninstall.
- [promise.md](guide/promise.md) — the LibrePortal Promise: free/open, no paywalls, no telemetry, in plain language.

## contributing/ — working on LibrePortal
- [contributing.md](contributing/contributing.md) — how to contribute (DCO sign-off, no CLA).
- [development.md](contributing/development.md) — run a dev copy, cut stable/edge releases, test before publishing.

## architecture/ — how it's built
- [system-footprint.md](architecture/system-footprint.md) — everything LibrePortal places outside its data roots, and who owns it.
- [webui-architecture.md](architecture/webui-architecture.md) — the WebUI component-module system (as-built).

## roadmap/ — where it's going
- [updates-and-distribution.md](roadmap/updates-and-distribution.md) — vision for hotfixes, the "Updates & Improvements" front door, and registry-not-marketplace distribution.