Tt-rss - Revision history

Ntninja: Added Caddy web server configuration (hopefully I’ll be able to upstream this at some point)

2025-05-18T12:57:19Z

Added Caddy web server configuration (hopefully I’ll be able to upstream this at some point)

@@ Line 14: / Line 14: @@
    selfUrlPath = "https://example.com/tt-rss";
 };
 </syntaxhighlight>

Klinger: description and link

2024-06-25T19:02:31Z

description and link

← Older revision		Revision as of 19:02, 25 June 2024
Line 1:		Line 1:
			[https://tt-rss.org/ Tiny Tiny RSS] is a free and open source web-based news feed (RSS/Atom) reader and aggregator.

	__TOC__		__TOC__

Mic92: imported from old wiki

2024-06-23T10:24:08Z

imported from old wiki

New page

__TOC__

== Install ==

<syntaxhighlight lang="nix>
services.tt-rss = {
enable = true;
# to configure a nginx virtual host directly:
virtualHost = "tt-rss.example.com";
selfUrlPath = "https://tt-rss.example.com";
# or for hosting on sub-path:
selfUrlPath = "https://example.com/tt-rss";
};
</syntaxhighlight>

== Configuration ==

By default tt-rss creates an '''admin''' user with password '''password'''. After logging in for the first time, do not forget to '''change it'''!

=== Disabling the ''admin'' user completely ===
After installing and creating a new user, you can disable the ''admin'' by setting its access level to -2 [https://srv.tt-rss.org/ttrss-docs/classes/UserHelper.html#constant_ACCESS_LEVEL_DISABLED].

Either manually by running:
<syntaxhighlight lang="shell">
sudo -u tt_rss nix-shell -p php \
--run 'php /var/lib/tt-rss/www/update.php --user-set-access-level "admin:-2"'
</syntaxhighlight>

You can even automate this to ensure it is always set to -2 by e.g. utilising a ''PreStart'' snippet:
<syntaxhighlight lang="nix">
systemd.services.tt-rss.preStart = lib.mkAfter ''
${pkgs.php}/bin/php ${config.services.tt-rss.root}/www/update.php \
--user-set-access-level "admin:-2"
'';
</syntaxhighlight>

=== Enabling TLS for nginx virtual host ===

Assuming you have ACME set-up for ''example.com'':
<syntaxhighlight lang="nix">
services.nginx.virtualHosts."${config.services.tt-rss.virtualHost}" = {
forceSSL = true;
useACMEHost = "example.com"
};
</syntaxhighlight>

[[Category:Guide]]
[[Category:Server]]
[[Category:Web Applications]]