Skip to content

FreshRSS: new service - #334

Open
kevinpurdy wants to merge 1 commit into
tailscale-dev:mainfrom
kevinpurdy:freshrss-service
Open

FreshRSS: new service#334
kevinpurdy wants to merge 1 commit into
tailscale-dev:mainfrom
kevinpurdy:freshrss-service

Conversation

@kevinpurdy

Copy link
Copy Markdown

Add a FreshRSS service directory following the ScaleTail service template, and list it under Media and Entertainment in the front-page README.

FreshRSS is a self-hosted RSS/Atom aggregator with Google Reader- and Fever-compatible APIs, so mobile clients can sync against the instance over the Tailnet.

Notes on the configuration:

  • Tailscale Serve proxies to 127.0.0.1:80, the port the FreshRSS Apache image listens on by default.
  • TRUSTED_PROXY=127.0.0.1 so Apache trusts X-Forwarded-For from Serve across the shared network namespace; without it every visitor is logged as 127.0.0.1.
  • FRESHRSS_INSTALL and FRESHRSS_USER drive the unattended installer. These are the only way the admin credentials in .env reach the app, and they apply on first run only.
  • Health check uses ./cli/health.php, which ships with the image.
  • SQLite by default; the README documents swapping in an external DB.

Servicename: context

FreshRSS: RSS/Atom feed

Description

A customizable feed reader with themes, extensions, and no separate database.

Related Issues

  • None.

Verification

❯ docker compose ps
NAME                 IMAGE                        COMMAND                  SERVICE       CREATED      STATUS                PORTS
app-freshrss         freshrss/freshrss:latest     "./Docker/entrypoint…"   application   7 days ago   Up 7 days (healthy)
tailscale-freshrss   tailscale/tailscale:latest   "/usr/local/bin/cont…"   tailscale     7 days ago   Up 7 days (healthy)

Checklist

  • I have performed a self-review of my code and followed the templates structure.
  • I have added verification that the stack works as expected.
  • I have updated necessary documentation (e.g. frontpage README.md ).
  • I have selected the correct label(s) for this PR.

Additional Context

Claude Code utilized in compose/readme preparation, but all material reviewed (and corrected) by human being Kevin Purdy.

Add a FreshRSS service directory following the ScaleTail service template,
and list it under Media and Entertainment in the front-page README.

FreshRSS is a self-hosted RSS/Atom aggregator with Google Reader- and
Fever-compatible APIs, so mobile clients can sync against the instance
over the Tailnet.

Notes on the configuration:
- Tailscale Serve proxies to 127.0.0.1:80, the port the FreshRSS Apache
  image listens on by default.
- TRUSTED_PROXY=127.0.0.1 so Apache trusts X-Forwarded-For from Serve
  across the shared network namespace; without it every visitor is
  logged as 127.0.0.1.
- FRESHRSS_INSTALL and FRESHRSS_USER drive the unattended installer.
  These are the only way the admin credentials in .env reach the app,
  and they apply on first run only.
- Health check uses ./cli/health.php, which ships with the image.
- SQLite by default; the README documents swapping in an external DB.
@ironicbadger

Copy link
Copy Markdown
Collaborator

👀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants