Add hardening and deployment: admin dashboard, security headers, install docs

Adds an admin-only dashboard (apps/core) surfacing feeds that are failing to
fetch, with error messages, subscriber counts, and a one-click retry that
resets backoff and re-queues the fetch.

Hardens config/settings/prod.py with the remaining standard Django security
settings (HSTS preload, nosniff, referrer-policy, frame-options, SameSite
cookies) plus a Content-Security-Policy header via django-csp, as a second
layer behind nh3's HTML sanitization of feed content.

Adds docs/install.md (pip + gunicorn + systemd + nginx, SQLite and Postgres
both covered) plus the systemd units and nginx snippet it references,
LICENSE (AGPL-3.0-or-later, matching pyproject.toml), and an updated README.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
ksmithandClaude Sonnet 5 committed 2026-10-30 20:10:31 -06:00
1 parent 7577110238
commit 3f6474ce94
16 files changed
+1226 -6

No files matched your search

+21 -3
View File
@@ -1,10 +1,23 @@
# Evection
A self-hosted RSS/Atom feed reader, in the spirit of FreshRSS, built in Python
(Django) instead of PHP. Installable as a PWA on mobile.
(Django) instead of PHP. Installable as a PWA on your phone, with offline
reading for anything you've already loaded.
Status: early scaffolding — auth and accounts are in place; feed fetching,
reading UI, search, rules, OPML, and the PWA layer are still to come.
## Features
- Multi-user, with per-user folders, read/starred/saved-for-later state, and tags
- Background feed polling via Celery, with conditional GET and backoff on errors
- Full-text search over your articles (SQLite FTS5 or PostgreSQL, your choice)
- A filter/rules engine to auto-tag, star, hide, or mark feeds' articles read
- OPML import/export
- Installable as a PWA (Add to Home Screen) with an offline fallback page
- An admin dashboard surfacing feeds that are failing to fetch
## Deploying your own instance
See [docs/install.md](docs/install.md) for a production install: pip + gunicorn
+ systemd + nginx, with both SQLite and PostgreSQL covered.
## Development setup
@@ -27,3 +40,8 @@ pytest
ruff check .
black --check .
```
## License
[GNU AGPL-3.0-or-later](LICENSE) — if you run a modified version of Evection as
a network service, you must make your modified source available to its users.