Difference between revisions of "TT-RSS"

From ArchWiki
Jump to: navigation, search
(Set up web server and php)
m (Add Category. See Help:Category. Fix some style. See Help:Style.)
Line 1: Line 1:
 +
[[Category:Internet Applications]]
 
Tiny Tiny RSS is an open source web-based news feed (RSS/Atom) aggregator, designed to allow you to read news from any location, while feeling as close to a real desktop application as possible.
 
Tiny Tiny RSS is an open source web-based news feed (RSS/Atom) aggregator, designed to allow you to read news from any location, while feeling as close to a real desktop application as possible.
  
 
==Installation==
 
==Installation==
Install from [[AUR]]: https://aur.archlinux.org/packages/tt-rss/
+
Install from [[AUR]]:{{AUR|tt-rss}}
  
 
===Set up database===
 
===Set up database===
Line 21: Line 22:
 
tt-rss is installed into {{ic|/usr/share/webapps/tt-rss/}}; you'll need to make this directory available from your web server. The simplest way is to do
 
tt-rss is installed into {{ic|/usr/share/webapps/tt-rss/}}; you'll need to make this directory available from your web server. The simplest way is to do
  
  $ sudo ln -s /usr/share/webapps/tt-rss /srv/http/tt-rss  
+
  # ln -s /usr/share/webapps/tt-rss /srv/http/tt-rss  
  
 
====Closing basedirs for non-tt-rss webapps====
 
====Closing basedirs for non-tt-rss webapps====
Line 40: Line 41:
 
See http://tt-rss.org/redmine/projects/tt-rss/wiki/UpdatingFeeds – but you should be able to simply
 
See http://tt-rss.org/redmine/projects/tt-rss/wiki/UpdatingFeeds – but you should be able to simply
  
  $ sudo systemctl enable tt-rss-updated
+
  # systemctl enable tt-rss-updated
  
 
Do  
 
Do  

Revision as of 04:44, 20 March 2013

Tiny Tiny RSS is an open source web-based news feed (RSS/Atom) aggregator, designed to allow you to read news from any location, while feeling as close to a real desktop application as possible.

Installation

Install from AUR:tt-rssAUR

Set up database

You'll need to set up a database, either mysql or postgresql. Create a user and database, e.g. with mysql:

$ mysql -p -u root
mysql> CREATE USER 'ttrss'@'localhost' IDENTIFIED BY 'somepassword';
mysql> CREATE DATABASE 'ttrss';
mysql> GRANT ALL PRIVILEGES ON ttrss.* TO "ttrss"@"localhost" IDENTIFIED BY 'somepassword';

Then create the initial tables:

mysql --user=ttrss --host=localhost --password=somepassword ttrss < /usr/share/webapps/tt-rss/schema/ttrss_schema_mysql.sql

Set up web server and php

tt-rss requires that the value of open_basedir is "none". You can set this /etc/php/php.ini (then sudo systemctl restart httpd).

tt-rss is installed into /usr/share/webapps/tt-rss/; you'll need to make this directory available from your web server. The simplest way is to do

# ln -s /usr/share/webapps/tt-rss /srv/http/tt-rss 

Closing basedirs for non-tt-rss webapps

If you want the php open_basedir setting to only apply to the tt-rss location, you can add this to /etc/httpd/conf/httpd.conf:

<Location /tt-rss/>
      php_admin_value open_basedir none 
</Location>

However, this will make the update daemon (see below) fail. It might be able to fix it by making your own daemon that uses its own php.ini file, or simply a crontab entry like this (assuming you put the ini file into /etc/webapps/tt-rss:

* * * * * sudo -u http /usr/bin/php -c /etc/webapps/tt-rss/php.ini /usr/share/webapps/tt-rss/update.php -feeds &>/var/log/tt-rss.log

Set up config.php

Copy /etc/webapps/tt-rss/config.php-dist to /etc/webapps/tt-rss/config.php. Fill in your database server info and other necessary parameters.

Set up an update daemon

See http://tt-rss.org/redmine/projects/tt-rss/wiki/UpdatingFeeds – but you should be able to simply

# systemctl enable tt-rss-updated

Do

$ systemctl status tt-rss-updated

to check that it's running fine.