2014-03-17

Most of the information here was incorrect, installing tt-rss is much simpler. Credit goes to "ewigkeit" for the right solution (https://bbs.archlinux.org/viewtopic.php?id=176288)

← Older revision

Revision as of 11:39, 17 March 2014

Line 6:

Line 6:

 

Install {{pkg|tt-rss}} from the [[official repositories]].

 

Install {{pkg|tt-rss}} from the [[official repositories]].

 

 



===Set up database===

+

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

 

+

 

 

+

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

 

+

 

 

+

===Set up
php and
database===

 

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

 

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

 

 

Line 14:

Line 18:

 

  mysql> GRANT ALL PRIVILEGES ON ttrss.* TO "ttrss"@"localhost" IDENTIFIED BY 'somepassword';

 

  mysql> GRANT ALL PRIVILEGES ON ttrss.* TO "ttrss"@"localhost" IDENTIFIED BY 'somepassword';

 

 



Then create the initial tables:

+

You
also
need to
add some paths
to /etc/php/php.ini:



 

+



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 {{ic|sudo systemctl restart httpd}}).

+



 

+



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

+



 

+



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

+



 

+



====Custom php.ini and Closing basedirs for non-tt-rss webapps====

+



[note: update_daemon2.php has been changed and no longer passes on the php.ini config specified by -c. This will not work until that is fixed.]

+



 

+



If you want the php open_basedir setting to only apply to the tt-rss location, you can create a custom php config file for tt-rss. Copy your {{ic|
/etc/php/php.ini
}} file to {{ic|/etc/webapps/tt-rss/php.ini}} and edit open_basedir and any other options specific to tt-rss. Then add to your apache config:

+



 

+



<Location /tt-rss/>

+



      PHPINIDir /etc/webapps/tt-rss

+



</Location>

+



 

+



or your apache vitural host config:

+



+



<VirtualHost *:80>

+



      ...

+



      PHPINIDir /etc/webapps/tt-rss

+



</VirtualHost>

+



 

+



Note: the {{ic|VirtualHost}} solution is tested and working, users have reported issues adding {{ic|PHPINIDir}} to {{ic|Location}}.

+



 

+



However, this will make the update daemon (see below) fail. You can work around this by passing a custom {{ic|php.ini}} file to php and using the  {{ic|update_daemon2.php}} updater (update.php starts additional php instances and does not pass on the php config file). The following systemd unit file will accomplish that (replace "mysqld.service" with your appropriate SQL service)
:

+

 

 



  [Unit]

+

...



  Description
=
Tiny tiny
rss
feed updater daemon

+

include_path
=
"... :/etc/webapps/tt-
rss
"



  After=network
.
target mysqld
.
service

+

.
..



 

+

open_basedir
=
... :
/usr/
share
/
webapps/:
/etc/webapps/
:
/
var
/
lib
/tt-rss



  [Service]

+

.
..



  ExecStart
=/usr/
bin
/
php -c
/etc/webapps/
tt-rss
/
php.ini
/
usr/share/webapps
/tt-rss
/update_daemon2
.
php --quiet

+



  User=http

+



  StandardOutput=syslog

+



 

+



  [Install]

+



  WantedBy=multi-user
.
target

+

 

 



Finally, in your (custom or system) {{ic|php.ini}}
file
you'll need to
enable
several extensions. Uncomment
the following:

+

In the same
file
,
enable the following
modules
:

 

 



 
extension=curl.so

+

extension=curl.so



 
extension=iconv.so

+

extension=iconv.so



 
extension=mysql.so

+

extension=mysql.so



 
extension=posix.so

+

extension=posix.so



 
extension=soap.so

+

extension=soap.so

 

 



===Set up config.php===

+

You should now be able to navigate to (your
-
servers
-
root)
/tt-rss and
proceed with the installer
.



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

+



Make sure your web-server is allowed to read {{ic|/etc/webapps/tt-rss/config.php}} or else you will just see a blank page
.

+

 

 

 

===Set up an update daemon===

 

===Set up an update daemon===

Show more