TrueNAS Scale FreshRSS

Last Edit: 2025.09.05

Overview

Setup FreshRSS on TrueNAS Scale.

Assumptions

Install FreshRSS

Navigate to the Applications page in the TrueNAS Scale dashboard, Apps on the main navigation.

Switch to the Available Applications tab in the Applications page.

Using the search tool, find the freshrss application. Verify FreshRSS is from the TrueNAS catalog and is on the Community train.

Select Install to begin configuration and installation of the application. Configuration options not mentioned in this section can be left as default.

Application Name

SettingValueDescription
Application NamefreshrssName for the application.
Version Number#.#.#Version to use, latest by default.

FreshRSS Configuration

SettingValueDescription
Postgres ImagePostgres 17On new installations, use Postgres 17. If importing an existing Postgres 15 database, use Postgres 15 until ready to upgrade. Database upgrades are one-way.
Default Admin UseradministratorAssign a username for the FreshRSS admin user.
Default Admin PasswordGenerated-Secure-PasswordGenerate a secure password for the admin user.
Cron Min*/15Cron expression in minutes for FreshRSS feed job.
Database PasswordGenerated-Secure-PasswordGenerate a secure database password.

Network Configuration

SettingValueDescription
Port Bind ModePublish port on the host for external accessPublish the port for external access.
WebUI Port30108Port FreshRSS service will be exposed on.
Host IPs0.0.0.0Optionally, specify a Host IP. If there is a dedicated local network interface for containers, specify that address here.

Storage Configuration

Keep the default values to have FreshRSS use system ixVolumes.

SettingValueDescription
FreshRSS Data StorageixVolumeContainer storage.
FreshRSS Extensions StorageixVolumeExtension storage.
FreshRss Postgres Data StorageixVolumeDatabase storage.

Resources Configuration

SettingValueDescription
CPU Limit1Configure a CPU thread limit for the application. 1 should be adequate for small deployments.
Memory Limit2048Memery limit in megabytes. 2 gigabytes should be adequate for small deployments.

Install

Verify you have checked the TrueNAS documentation for FreshRSS and Install. The application will complete installation and deploy. Navigate to the Applications tab to monitor the status.

NPM Proxy Host

Add a Nginx Proxy Manager proxy host for the Freshrss service.

From the Nginx Proxy Manager dashboard, select Proxy Hosts under Hosts.

Select Add Proxy Host from the Proxy Hosts dashboard.

Proxy Host Details

Configure the new proxy host details.

SettingValueDescription
Domain Namesfreshrss.system.example.comHostname used to access Freshrss, must have a matching DNS record.
Forward Hostname / IP172.16.13.13Use the IP addess of the host server. The loopback address will not work.
Forward Port30108Use the mapped service port, not the internal Docker port.
Cache Assetsfalse
Block Common Exploitstrue
Websockets Supportfalse
Access ListlocalOptionally, use the configured access list to limit devices that can connect.

Proxy Host SSL

Switch to the SSL tab for the new proxy host and configure it to use the generated certificate.

SettingValueDescription
SSL Certificate*.system.example.comUse the generated certificate.
Force SSLtrue
HTTP/2 Supporttrue
HSTS Enabledtrue
HSTS Subdomainstrue

Nginx proxy host SSL.

Proxy Host Connect

Save the new proxy host and view the added host in the proxy hosts list.

If a local DNS server is setup, verify there is a wildcard entry for the local server or create one specifially for Freshrss.

If there is no local DNS server yet, add a custom host entry to /etc/hosts.

sudo nano /etc/hosts

Add the required domain(s) and point them to the host server IP address.

172.16.13.13 system.example.com
172.16.13.13 npm.system.example.com
172.16.13.13 freshrss.system.example.com

Navigate to the Freshrss service with the configured domain, no port required if Nginx Proxy Manager was assigned port 80/443.

https://freshrss.system.example.com/

Connect

Initial deployment may take a while. Connect to the FreshRSS service in a browser at the configured domain, https://freshrss.system.example.com/. Login using the admin credentials configured during deployment.

FreshRSS login page.

Add User

Add a non-administrative user(s) for the system. From the main feed dashboard, select Settings then Manage Users. Fill out the Create new user form, Create, and the user will be ready to start adding feeds.

FreshRSS manage users page.

Feeds

Get started adding some feeds, select Subscription Management from the FreshRSS dashboard to manage feeds and feed categories. When adding a feed, enable Verify SSL Security whenever possible for the feed in question. Default feed settings will work for many public feeds.

FeedLink
NASA - ISShttps://www.nasa.gov/missions/station/feed/
NASA - JPLhttps://www.nasa.gov/centers-and-facilities/jpl/feed/
NASA - News Releasehttps://www.nasa.gov/news-release/feed/
NASA - Technologyhttps://www.nasa.gov/technology/feed/
PBS - USA Newshttps://www.pbs.org/newshour/feeds/rss/headlines

FreshRSS feed management page.

References

1 2 3 4 5 6 7


  1. iXsystems. “TrueNAS Documentation.” 2025. ↩︎

  2. iXsystems. “TrueNAS FreshRSS Documentation.” 2025. ↩︎

  3. FreshRSS. “FreshRSS Documentation.” 2025. ↩︎

  4. FreshRSS. “FreshRSS GitHub.” 2025. ↩︎

  5. iXsystems. “TrueNAS Nginx Proxy Manager Documentation.” 2025. ↩︎

  6. Nginx Proxy Manager. Nginx Proxy Manager Documentation. 2024. ↩︎

  7. Nginx Proxy Manager. “Nginx Proxy Manager GitHub.” 2024. ↩︎