TinyTinyRSS

From SME Server
Revision as of 20:20, 3 December 2021 by Trex (talk | contribs) (→‎Description)
Jump to navigationJump to search


Maintainer

We have now imported these contribs originally built by Daniel into smecontribs.

[1]Daniel B. from Firewall Services

Version

Contrib 10:
smeserver-tt-rss
The latest version of smeserver-tt-rss is available in the SME repository, click on the version number(s) for more information.


tt-rss
The latest version of tt-rss is available in the SME repository, click on the version number(s) for more information.


Description

Tiny Tiny RSS is a web based feed reader. You can take a look at the online demo, login - demo, demo

Installation 9.x

v9 is now EOL and deprecated

Installation v10.x

Warning.png Warning:
These contribs are still in the smetest repo for testing


To install normally you would use the following:

yum --enablerepo=smecontribs install smeserver-tt-rss

You should not need a reboot.

Any changes should be activated with

signal-event webapps-update

You can now access the application using this URL: https://your-server.domain.tld/tt-rss All users created on your SME Server can login with their usual credentials.


Information.png Tip:
be aware that after a major update of this contrib, a script db-updater.php is automatically launched by TinyTinyRSS and you need to give the default admin login and password (admin/password) to allow the script execution.


Additional options

Some settings are available from the DB

  • Authentication: Control the way users are authenticated. Correct values are http (apache protect the access), internal (uses the internal database to manage users and groups. An admin have to create user account before they can login). If you use the internal authentication mechanism, you need to login using admin/password. A last value is available for this prop: LemonLDAP which uses LemonLDAP-NG to validate credentials, and the internal ldap server to get user/group information. You can have more information on this later on this page.
  • MultiUser: If set to disabled, the application will only manage one profile, everyone will share the same settings, the same list of RSS etc...
  • AliasOnPrimary: can be enabled or disabled (default is enabled). This prop lets you disable the access to Tiny Tiny RSS on your primary domain (the alias /tt-rss won't be added in apache configuration). This is useful if you want the application to be available only with a virtualhost.
  • status (enabled|disabled). Enable or disable web access, as well as the demon update
  • access (public|private). Private by default, gives access only to local networks and the IP address are allowed to access in the server-manager ($ $ localAccess externalSSLAccess)

example:

db configuration setprop tt-rss AliasOnPrimary disabled
signal-event webapps-update


Important.png Note:
Keep in mind that if you want to use the application tiny-rss with a mobile phone (android of course) or a laptop outside of your wifi network, you must allow the application in Public way.


example:

db configuration setprop tt-rss access public
signal-event webapps-update

Integration with LemonLDAP::NG

Tiny Tiny RSS can be protected by LemonLDAP::NG. Here're the steps to protect it

Disable the access on the primary domain

You should disable the access to Tiny Tiny RSS on your primary domain:

db configuration setprop tt-rss AliasOnPrimary disabled
signal-event webapps-update

Enable LemonLDAP::NG integration

This contrib support LemonLDAP NG auth quite easily:

db configuration setprop tt-rss Authentication LemonLDAP
signal-event webapps-update

Create a new virtualhost for Tiny Tiny RSS

Lets create a new virtualhost for Tiny Tiny RSS. You can choose the name you want, for example, lets create rss.domain.tld:

db domains set rss.$(db configuration get DomainName) domain Content Primary Description 'Tiny Tiny RSS' \
DocumentRoot /usr/share/tt-rss Nameservers internet TemplatePath WebAppVirtualHost \
Authentication LemonLDAP
signal-event domain-create rss.$(db configuration get DomainName)
signal-event webapps-update

Declare this virtualhost in LemonLDAP

You can now create the virtualhost in LemonLDAP management interface. You can create the rules you want. For example, here're the rules to accept only members of the group 'rss'

  • Comment: default
  • Rule: $groups =~ /\brss\b/

Uninstall

If you want to remove the contrib, just run:

yum remove tt-rss


Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the tt-rss component or use this link .

"No open bugs found."


Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-tt-rss component or use this link .

IDProductVersionStatusSummary (2 tasks)
11966SME Contribs10.0CONFIRMEDUnable to open Unix domain Socket on web page access
11878SME Contribs10.0UNCONFIRMEDUnable to see pages after logging in (smeserver-ttrss)

Changelog

Only versions released in smecontrib are listed here.

smeserver-tt-rss Changelog: SME 10 (smecontribs)
2022/06/30 Michel Begue 0.5.0-3.sme
- update to httpd 2.4 syntax [SME: 12062]
2021/11/21 Michel Begue 0.5.0-2.sme
- Fix log file not fed

2021/11/01 Michel Begue 0.5.0-1.sme
- First import to sme 10
- systemd, update event & php-fpm

- Support tt-rss 20211029

2017/07/13 Daniel Berteaud 0.3.0-1.sme
- Switch to php fpm, using PHP 7.1

- Support tt-rss 20170713
2016/02/16 Daniel Berteaud 0.2.11-1.sme
- Remove SESSION_CHECK_ADDRESS