# Stashix 0.0.1

LLMS index: [llms.txt](/llms.txt)

---

> [!NOTE]
> This version has not been released yet. The notes below may still change.

## Added

- Self-hosted library server for comics and ebooks, with multiple libraries
  and folder watching.
- In-browser readers for CBZ, CBR, CB7 and PDF.
- Metadata from file names, ComicInfo.xml and MetronInfo.xml, plus matching
  against external metadata sources.
- Series, publisher (with aliases) and creator pages; full-text search.
- Admin and user roles with per-library access and age ratings.
- Light and dark themes; installable as a PWA.
- Prometheus metrics on a separate port.
- Docker image at `git.aroy-art.com/aroy/stashix`.

## Known issues

- The metrics listener (port 9568) has no authentication. It is not published
  by `docker-compose.yml`; set `:metrics_ip` to restrict it.
- `X-Forwarded-For` is trusted from any client, so the IP shown in the
  sessions list can be spoofed.
- Library files with many made-up XML element names can, over many scans,
  exhaust the atom table and crash the server.

[Release notes on the Stashix repository](https://git.aroy-art.com/aroy/stashix/releases/tag/v0.0.1)

---

Backlinks:

- [Introducing Stashix](/blog/post/introducing-stashix/)