Portainer/freshrss/README.md

FreshRSS

Lector RSS personal publicado en rss.sherlockhomeless.net.

Qué hace y arquitectura

FreshRSS agrega feeds, actualiza artículos mediante cron y ofrece una API compatible con clientes móviles. Este despliegue usa SQLite: datos, usuarios y configuración viven en FRESHRSS_DATA_PATH; las extensiones se separan en FRESHRSS_EXTENSIONS_PATH.

Configuración

• FRESHRSS_DOMAIN define el dominio usado por Traefik.
• FRESHRSS_CRON_MIN controla la frecuencia de actualización; una frecuencia agresiva aumenta carga y peticiones a los sitios origen.
• FRESHRSS_ENV debe permanecer en producción.
• La web pasa por Authentik, pero la ruta de API no puede usar ese forward-auth porque los clientes móviles no completan el flujo web. Activa la API en el perfil de FreshRSS y usa una contraseña API distinta de la contraseña principal.
• No usa Sablier para que cron pueda actualizar feeds incluso sin visitas.

Despliegue

docker compose --env-file .env config
docker compose --env-file .env up -d

El primer acceso abre el instalador de FreshRSS. Para este servidor se usa SQLite con persistencia en /opt/freshrss.

El enrutado publico vive en /opt/traefik/dynamic/freshrss.yml. La web pasa por Authentik, pero la API de FreshRSS queda expuesta sin SSO para clientes moviles. FreshRSS no usa Sablier y las apps deben usar la contrasena API del usuario.