> ## Documentation Index
> Fetch the complete documentation index at: https://www.towbar.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# FreshRSS

> FreshRSS gathers updates from websites and feeds into one reading app.

export const UseCaseNavigation = () => {
  useLayoutEffect(() => {
    const storageKey = "towbar-use-case-open-groups";
    const groupSelector = "#sidebar li[data-title] > button[aria-expanded]";
    let restoring = false;
    let frame = 0;
    function storedGroups() {
      try {
        return new Set(JSON.parse(sessionStorage.getItem(storageKey) || "[]"));
      } catch {
        return new Set();
      }
    }
    function save(groups) {
      try {
        sessionStorage.setItem(storageKey, JSON.stringify([...groups]));
      } catch {}
    }
    function groupName(button) {
      return button.parentElement?.dataset.title;
    }
    function rememberOpenGroups() {
      const groups = new Set();
      for (const button of document.querySelectorAll(groupSelector)) {
        if (button.getAttribute("aria-expanded") === "true") {
          const name = groupName(button);
          if (name) groups.add(name);
        }
      }
      save(groups);
    }
    function restoreOpenGroups() {
      frame = 0;
      const groups = storedGroups();
      if (!groups.size) return;
      restoring = true;
      for (const button of document.querySelectorAll(groupSelector)) {
        if (groups.has(groupName(button)) && button.getAttribute("aria-expanded") === "false") {
          button.click();
        }
      }
      restoring = false;
    }
    function scheduleRestore() {
      if (!frame) frame = requestAnimationFrame(restoreOpenGroups);
    }
    function onClick(event) {
      if (restoring || !(event.target instanceof Element)) return;
      const button = event.target.closest(groupSelector);
      if (button) {
        const name = groupName(button);
        if (!name) return;
        const groups = storedGroups();
        if (button.getAttribute("aria-expanded") === "true") groups.delete(name); else groups.add(name);
        save(groups);
        return;
      }
      if (event.target.closest('a[href^="/docs/use-cases/"]')) {
        rememberOpenGroups();
      }
    }
    const observer = new MutationObserver(scheduleRestore);
    document.addEventListener("click", onClick, true);
    observer.observe(document.getElementById("sidebar") || document.body, {
      childList: true,
      subtree: true
    });
    scheduleRestore();
    return () => {
      document.removeEventListener("click", onClick, true);
      observer.disconnect();
      cancelAnimationFrame(frame);
    };
  }, []);
  return null;
};

<UseCaseNavigation />

<img className="towbar-doc-brand-logo" src="https://mintcdn.com/avgeek/EGkEWLTQnOwecqNx/assets/use-case-logos/freshrss.svg?fit=max&auto=format&n=EGkEWLTQnOwecqNx&q=85&s=eb0fd2cccdadf6a16ea0bdad5467a6ec" alt="FreshRSS logo" aria-hidden="true" width="24" height="24" data-path="assets/use-case-logos/freshrss.svg" />

**Upstream source:** [Current installation guide](https://github.com/FreshRSS/FreshRSS/blob/edge/Docker/README.md).

For a first single-user installation, FreshRSS can keep its SQLite database and feed data in the named data volume. The extensions volume preserves installed extensions. `CRON_MIN` starts the image's built-in feed refresh schedule.

## Towbar manifest

```yaml title=".towbar/services/freshrss.service.yml" theme={"system"}
id: freshrss
name: FreshRSS
buildServer: null
deployment:
  type: image
  image: freshrss/freshrss:1.27.1
container:
  port: 80
  volumes:
    - name: data
      mountPath: /var/www/FreshRSS/data
      initialData: image
    - name: extensions
      mountPath: /var/www/FreshRSS/extensions
      initialData: image
environments:
  production:
    server: 192.0.2.10
rollout:
  type: recreate
  maintenanceMode: true
  reason: Persistent application data uses a single writer
secrets:
  runtime:
    - CRON_MIN
domains:
  primary: freshrss.example.com
tls:
  mode: direct
```

## Configure

1. Prepare the example server, connect the repository, and map `production` to the branch containing these manifests. Replace the example server IP and domain. Commit the manifests, then sync the repository and inspect the resolved configuration.
2. Set the Service's declared runtime values under **Service → Settings → Secrets** using the table below. Replace descriptions and placeholders with actual values; do not commit passwords or keys.
3. Keep the Service's named volumes attached across deployments. Towbar's Datastore backup policy does not back up Service volumes, so include them in your own recovery plan.
4. Deploy the Service, then perform the checks below before enabling auto-deploy.

## Runtime values

Save these values on the Service after the repository sync. The manifest declares required keys, not their values.

| Key        | Value to save                                                             |
| ---------- | ------------------------------------------------------------------------- |
| `CRON_MIN` | 13,43 (refresh feeds twice per hour using the image's built-in scheduler) |

## Verify

Complete setup with SQLite, subscribe to a feed, and verify new articles arrive on the next scheduled refresh and remain after redeployment.

For field constraints, see [Service manifest](/docs/services/manifest).