- Offizieller Beitrag
Installation von TinyTiny RSS auf einem RaspberryPi
Installations-Voraussetzungen:
- Ein lauffähiger Webserver; zahlreiche Anleitungen finden sich hier im Forum und in diversen Blogs (Zum Beispiel für Apache2, nginx, lighthttpd)
- php muss installiert sein (Anleitungen dafür finden sich auch hier im Forum)
- git zur Installation und Update der Software
- Neben php benötigt ihr entweder eine Instanz von mySQL oder PostgreSQL (Empfolen)
Darüber hinaus ist es ratsam, wenn ihr euren Pi mindestens auf 800mhz übertaktet um eine ansprechende Performance zu erzielen.Auf Pis einer neueren Generation sollte die Performance kein Problem mehr darstellen, sofern die Anzahl eurer Abos halbwegs überschaubar bleibt
Die unter Installations-Voraussetzungen aufgeführten Dinge setze ich voraus. Auf diese Punkte werde ich in diesem Tutorial nicht mehr näher eingehen, da deren Installation hinreichend dokumentiert ist.
Es ist möglich, dass einige Distributionen Binärpakete von ttrss bereit stellen, diese Pakete sind allerdings in den meisten Fällen sehr veraltet, Ich rate also dazu die hier beschriebenen Installationsmethode zu verwenden
TinyTiny RSS setzt auf ein Rolling-Release Modell; d.h. die Instalation erfolgt immer duch Klonen des entsprechenden Git-Repos. Es werden keine Point-Releases ausgegeben.
Installation von TTRSS:
- als Erstes begeben wir uns in der Verzeichnis in dem sich unsere für den Webserver relevanten Dateien befinden. In der Regel ist das /var/www
- wenn wir uns im Verzeichnis befinden machen wir uns an den eigentlichen Download von TTRSS
- wenn der Download und das Erstellen eines Verzeichnis erfolgreich war, können wir uns darum kümmern eine mySQL bzw. Postgresql Datenbank anzulegen. Dies kann über die Konsole alternativ aber auch via. phpmyadmin bzw. pgAdmin erledigt werden. Da mir phpmyadmin schon jeher irgendwie unsicher erscheint erledige ich diese Aufgabe im Terminal.
Bitte beachtet, dass laut Entwickler der Software mit Postgresql wesentlich besere Performance-Ergebnisse erreicht werden können.
Für Postgresql:
Für Mysql:
Codemysql -u root -p create database if not exists ttrss; create user 'www-data'@'localhost' identified by 'dein gewähltes Passwort'; grant usage on *.* to 'www-data'@'localhost' identified by 'dein gewähltes Passwort'; grant all privileges on ttrss.* to 'www-data'@'localhost'; flush privileges; quit;
In diesen beiden Beispielen hier erstelle ich einen neuen Benutzer www-data, da es nicht ratsam ist Webanwendungen als root-Benutzer der Datenbank zu betreiben, wenn ihr auf eurem Raspberry Pi bereits einen neuen Datenbank-Nutzer erstellt habt oder ihr tatsächlich den root-User verwenden wollt, könnt ihr den entsprechenden Teil der Befehle natürlich aus lassen. - Nun ist er Zeit zum ersten mal eure Instanz von TTRSS in Browser aufzurufen.
Falls ihr die Ip-Adresse eures Raspberry Pi nicht kennen solltet, so könnt ihr sie mit dem kleinen Tool ifconfig herrausfinden.
Ruft nun also im Browser die Seite http://dieIPeuresRapberryPi/ttrss/install
auf. Ihr werdet nun aufgefordert werden eure SQL-Zugangsdaten einzugeben. Relativ selbsterklärend wie ich finde.
Database type: MYSQL bzw. PostegreSQL
Username: Der Name des von dir in Schritt drei erstellten Benutzers
Passwort: Das von dir in Schritt drei gewählte SQL Passwort
Database name: ttrss
Datenbank-Host: localhost
Port: Der MYSQL bzw. Postgresql Standard-Port. Liefert TTRSS direkt mit.
Tiny Tiny RSS URL: http://dieIPeuresRapberryPi/ttrss/
- Habt ihr alles korrekt eingegeben sollte der Installer nun eine SQL-Verbindung herstellen können und ihr könnte eure Datenbank initialisieren. Der Installer wird nun eine passende config.php ausgeben und versuchen diese in /ttrss zu schreiben. Der Schreibvorgang funktioniert in der Regel nicht richtig, ihr müsst als nochmal händisch ran. Wir schmeißen also wieder ein Terminal an und begeben uns in unser TTRSS Verzeichnis anschließend erstellen wir eine config.php und fügen den Inhalt der config.php der uns eben im Browser ausgeben wurde. Speichern und fertig.
- Als finalen Schritt der Installation müsst ihr nun noch einige Rechte anpassen, damit TTRSS zum Beispiel Bilder zwischenspeichern kann. Also wieder ab ins Terminal und folgenden Befehl ausgeführt
Die eigentliche Installation ist hiermit abgeschlossen und ihr solltet euch einloggen können. Die standard Login Daten sind Benutzer: admin und Passwort: password. Ich lege euch dringend ans Herz die Zugangsdaten in den Einstellungen umgehend zu verändern.
Feed-Updates einrichten
Wenn ihr nun eure Abonnements in Tiny Tiny Rss übernommen habt werdet ihr festellen, dass sich nach dem einmaligen Abrufen der Feeds nicht mehr viel tut. Gar nichts um genau zu sein.
Um deine Feeds zu aktualisieren gibt es verschiedene Möglichkeiten
Feed-Updates via systemd Service
Sofern auf eurem Pi eine halbwegs aktuelle Linux Distribution zum Einsatz kommt, so verfügt euer System mit großer wahrscheinlichkeit über systemd.
Der einfachste weg eure Feeds aktuell zu halten ist einen kleinen systemd-Service zu schreiben, der das für euch erledigt.
Erstellt dazu einfach im /etc/systemd/system Verzeichnis eine neue .service Datei mit einem beliebigen Namen, ttrss.service würde sich hier beispielsweise anbieten. Kopiert anschließend folgenden Inhalt in die Datei:
[Unit]
Description=ttrss_backend
After=network.target mysql.service postgresql.service
[Service]
User=www-data
ExecStart=/var/www/ttrss/update_daemon2.php
[Install]
WantedBy=multi-user.target
Achtet darauf den ExecStart entsprechend euer Installation anzupassen.
Im Anschluss kann der Dienst aktiviert und gestaret werden.
Feed-Updates via Cronjob
Eine andere Möglichkeit euere Feeds zu aktualiseren stellt ein Cronjob dar; geht dabei wie folgt vor:
sudo crontab -u www-data -e
*/15 * * * * cd /var/www/ttrss && /usr/bin/php update.php --feeds --quiet > /dev/null
Wenn ihr euren Raspberry Pi nun neustartet, werden aber dem Moment des Neustarts eure Feeds immer genau dann upgedatet, wenn es laut eurer Konfiguration nötig ist und ihr müsst nicht darauf warten, dass irgendwann ein Cronjob ausgeführt wird, der das erledigt.
Alternativ kannst du den Update-Befehl auch einfach im Terminal ausführen und ihn per Screen am Leben halten, nachdem du deine SSH Session beendet hast. Eine Einführung in die Funktionen von Screen findest du hier.
TTRSS updaten
Während es in der Vergangenheit möglich war ttrss direkt über die php-Anwendung auf den neusten Stand zu bringen, hat sich der Entwickler vor einer Zeit dazu entschieden ttrss auf ein Rolling Release System umzustellen, dies bedeutet dass keine Snapshots des Git-Repositories mehr zur Verfügung gestellt werden und Updates direkt aus dem Git Repository gemacht werden. Was kompliziert klingt ist in der Praxis tatsächlich viel einfacher.
Feeds auf dem Handy abrufen (iOS und Android)
Tiny Tiny Rss bietet die Möglichkeit eure Feeds.
Dazu müsst ihr in euren EInstellungen den API Zugriff aktivieren.
Android: Die passende App findet ihr in einer Trial Version im Playstore (der Unlocker kostet 4,09 Euro).
iOS: Für iOS steht eine inoffizielle App zur Verfügung.