1 Installation von wallabag
2 =========================
7 wallabag ist kompatibel mit PHP >= 5.5, inkl. PHP 7.
9 Du benötigst die folgenden Extensions damit wallabag funktioniert. Einige von diesen sind vielleicht schon in deiner Version von PHP aktiviert, somit musst du eventuell
10 nicht alle folgenden Pakete installieren.
27 wallabag nutzt PDO, um sich mit der Datenbank zu verbinden, darum benötigst du eines der folgenden Komponenten:
33 und dessen dazugehörigen Datenbankserver.
38 Auf einem dedizierten Webserver (empfohlener Weg)
39 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
41 wallabag nutzt eine große Anzahl an Bibliotheken, um zu funktionieren. Diese Bibliotheken müssen mit einem Tool namens Composer installiert werden. Du musst es installieren sofern du es bisher noch nicht gemacht hast.
43 Composer installieren:
47 curl -s http://getcomposer.org/installer | php
49 Du kannst eine spezifische Anleitung `hier <https://getcomposer.org/doc/00-intro.md>`__ finden:
51 Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen:
55 git clone https://github.com/wallabag/wallabag.git
58 SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
59 php bin/console wallabag:install --env=prod
61 Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen:
65 php bin/console server:run --env=prod
67 Und wallabag unter http://deineserverip:8000 erreichen
71 Um Parameter mit Umgebungsvariable zu definieren, musst du die Variable mit dem ``SYMFONY__`` Präfix setzen. Zum Beispiel ``SYMFONY__DATABASE_DRIVER``. Du kannst einen Blick die `Symfony Dokumentation <http://symfony.com/doc/current/cookbook/configuration/external_parameters.html>`__ werfen.
73 Auf einem geteilten Webhosting
74 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
76 Wir stellen ein Paket inkl. aller Abhängigkeiten bereit.
77 Die Standardkonfiguration nutzt SQLite für die Datenbank. Wenn du diese Einstellung ändern willst, ändere bitte ``app/config/parameters.yml``.
79 Wir haben bereits einen Nutzer erstellt: Login und Passwort sind ``wallabag``.
81 .. caution:: Mit diesem Paket überprüft wallabag nicht die von der Applikation gebrauchten Exentions (diese Tests werden während ``composer install`` durchgeführt wenn du einen dedizierten Webserver hast, siehe oben).
83 Führe dieses Kommando aus, um das neueste Paket herunterzuladen und zu entpacken:
87 wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
89 (md5 hash: ``4f84c725d1d6e3345eae0a406115e5ff``)
91 Jetzt lese die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf dein wallabag zu.
92 Wenn du die Datenbankkonfiguration eingestellt hast, MySQL oder PostgreSQL zu nutzen, musst du einen Nutzer über das folgende Kommando erstellen ``php bin/console wallabag:install --env=prod``.
94 Installation mit Docker
95 ------------------------
97 Wir stellen ein Docker Image zu Verfügung, um wallabag einfach zu installieren. Schaue in unser Repository in unserem `Docker Hub <https://hub.docker.com/r/wallabag/wallabag/>`__, um mehr Informationen zu erhalten.
99 Kommando, um den Container zu starten
100 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
104 docker pull wallabag/wallabag
109 Konfiguration von Apache
110 ~~~~~~~~~~~~~~~~~~~~~~~
112 Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren und du willst PHP als Apache Modul nutzen, dann ist hier ein vhost für wallabag:
117 ServerName domain.tld
118 ServerAlias www.domain.tld
120 DocumentRoot /var/www/wallabag/web
121 <Directory /var/www/wallabag/web>
126 <IfModule mod_rewrite.c>
129 RewriteCond %{REQUEST_FILENAME} !-f
130 RewriteRule ^(.*)$ app.php [QSA,L]
134 # uncomment the following lines if you install assets as symlinks
135 # or run into problems when compiling LESS/Sass/CoffeScript assets
136 # <Directory /var/www/wallabag>
137 # Options FollowSymlinks
140 # optionally disable the RewriteEngine for the asset directories
141 # which will allow apache to simply reply with a 404 when files are
142 # not found instead of passing the request into the full symfony stack
143 <Directory /var/www/wallabag/web/bundles>
144 <IfModule mod_rewrite.c>
148 ErrorLog /var/log/apache2/wallabag_error.log
149 CustomLog /var/log/apache2/wallabag_access.log combined
152 Nach dem du Apache neugeladen oder neugestartet hast, solltest du nun wallabag unter http://domain.tld erreichen.
154 Konfiguration von Nginx
155 ~~~~~~~~~~~~~~~~~~~~~~~
157 Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren, dann ist hier ein Rezept für wallabag:
162 server_name domain.tld www.domain.tld;
163 root /var/www/wallabag/web;
166 # try to serve file directly, fallback to app.php
167 try_files $uri /app.php$is_args$args;
169 location ~ ^/app\.php(/|$) {
170 fastcgi_pass unix:/var/run/php5-fpm.sock;
171 fastcgi_split_path_info ^(.+\.php)(/.*)$;
172 include fastcgi_params;
173 # When you are using symlinks to link the document root to the
174 # current version of your application, you should pass the real
175 # application path instead of the path to the symlink to PHP
177 # Otherwise, PHP's OPcache may not properly detect changes to
178 # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
179 # for more information).
180 fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
181 fastcgi_param DOCUMENT_ROOT $realpath_root;
182 # Prevents URIs that include the front controller. This will 404:
183 # http://domain.tld/app.php/some-path
184 # Remove the internal directive to allow URIs like this
188 error_log /var/log/nginx/wallabag_error.log;
189 access_log /var/log/nginx/wallabag_access.log;
192 Nach dem neuladen oder neustarten von nginx, solltest du nun wallabag unter http://domain.tld erreichen.
196 When you want to import large file into wallabag, you need to add this line in your nginx configuration ``client_max_body_size XM; # allows file uploads up to X megabytes``.
197 Wenn du eine große Datei in wallabag importieren willst, solltest du diese Zeile zu deiner nginx Konfiguration hinzufügen ``client_max_body_size XM; # allows file uploads up to X megabytes``.
199 Konfiguration von lighttpd
200 ~~~~~~~~~~~~~~~~~~~~~~~~~
202 Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren, dann ist hier ein Rezept für wallabag (bearbeite deine ``lighttpd.conf`` und füge die Konfiguration dort ein):
214 server.document-root = "/var/www/wallabag/web"
215 server.upload-dirs = ( "/var/cache/lighttpd/uploads" )
216 server.errorlog = "/var/log/lighttpd/error.log"
217 server.pid-file = "/var/run/lighttpd.pid"
218 server.username = "www-data"
219 server.groupname = "www-data"
221 server.follow-symlink = "enable"
222 index-file.names = ( "index.php", "index.html", "index.lighttpd.html")
223 url.access-deny = ( "~", ".inc" )
224 static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" )
225 compress.cache-dir = "/var/cache/lighttpd/compress/"
226 compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" )
227 include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port
228 include_shell "/usr/share/lighttpd/create-mime.assign.pl"
229 include_shell "/usr/share/lighttpd/include-conf-enabled.pl"
230 dir-listing.activate = "disable"
232 url.rewrite-if-not-file = (
233 "^/([^?]*)(?:\?(.*))?" => "/app.php?$1&$2",
234 "^/([^?]*)" => "/app.php?=$1",
237 Rechte, um das Projektverzeichnis zu betreten
238 ---------------------------------------------
243 Wenn wir nur wallabag testen wollen, führen wir nur das Kommando ``php bin/console server:run --env=prod`` aus, um unsere wallabag Instanz zu starten und alles wird geschmeidig laufen, weil der Nutzer, der das Projekt gestartet hat, den aktuellen Ordner ohne Probleme betreten kann.
248 Sobald wir Apache oder Nginx nutzen, um unsere wallabag Instanz zu erreichen, und nicht das Kommando ``php bin/console server:run --env=prod`` nutzen, sollten wir dafür sorgen, die Rechte vernünftig zu vergeben, um die Ordner des Projektes zu schützen.
250 Um dies zu machen, muss der Ordner, bekannt als ``DocumentRoot`` (bei Apache) oder ``root`` (bei Nginx), von dem Apache-/Nginx-Nutzer zugänglich sein. Sein Name ist meist ``www-data``, ``apache`` oder ``nobody`` (abhängig vom genutzten Linuxsystem).
252 Der Ordner ``/var/www/wallabag/web`` musst dem letztgenannten zugänglich sein. Aber dies könnte nicht genug sein, wenn wir nur auf diesen Ordner achten, weil wir eine leere Seite sehen könnten oder einen Fehler 500, wenn wir die Homepage des Projekt öffnen.
254 Dies kommt daher, dass wir die gleichen Rechte dem Ordner ``/var/www/wallabag/var`` geben müssen, so wie wir es für den Ordner ``/var/www/wallabag/web`` gemacht haben. Somit beheben wir das Problem mit dem folgenden Kommando:
258 chown -R www-data:www-data /var/www/wallabag/var
260 Es muss analog für die folgenden Ordner ausgeführt werden
262 * /var/www/wallabag/bin/
263 * /var/www/wallabag/app/config/
264 * /var/www/wallabag/vendor/
265 * /var/www/wallabag/data/
267 durch Eingabe der Kommandos
271 chown -R www-data:www-data /var/www/wallabag/bin
272 chown -R www-data:www-data /var/www/wallabag/app/config
273 chown -R www-data:www-data /var/www/wallabag/vendor
274 chown -R www-data:www-data /var/www/wallabag/data/
276 ansonsten wirst du früher oder später folgenden Fehlermeldung sehen:
280 Unable to write to the "bin" directory.
281 file_put_contents(app/config/parameters.yml): failed to open stream: Permission denied
282 file_put_contents(/.../wallabag/vendor/autoload.php): failed to open stream: Permission denied
284 Zusätzliche Regeln für SELinux
285 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
287 Wenn SELinux in deinem System aktiviert ist, wirst du zusätzliche Kontexte konfigurieren müssen damit wallabag ordentlich funktioniert. Um zu testen, ob SELinux aktiviert ist, führe einfach folgendes aus:
291 Dies wird ``Enforcing`` ausgeben, wenn SELinux aktiviert ist. Einen neuen Kontext zu erstellen, erfordert die folgende Syntax:
293 ``semanage fcontext -a -t <context type> <full path>``
297 ``semanage fcontext -a -t httpd_sys_content_t "/var/www/wallabag(/.*)?"``
299 Dies wird rekursiv den httpd_sys_content_t Kontext auf das wallabag Verzeichnis und alle darunterliegenden Dateien und Ordner anwenden. Die folgenden Regeln werden gebraucht:
301 +-----------------------------------+----------------------------+
302 | Vollständiger Pfad | Kontext |
303 +===================================+============================+
304 | /var/www/wallabag(/.*)? | ``httpd_sys_content_t`` |
305 +-----------------------------------+----------------------------+
306 | /var/www/wallabag/data(/.*)? | ``httpd_sys_rw_content_t`` |
307 +-----------------------------------+----------------------------+
308 | /var/www/wallabag/var/logs(/.*)? | ``httpd_log_t`` |
309 +-----------------------------------+----------------------------+
310 | /var/www/wallabag/var/cache(/.*)? | ``httpd_cache_t`` |
311 +-----------------------------------+----------------------------+
313 Nach dem diese Kontexte erstellt wurden, tippe das folgende, um deine Regeln anzuwenden:
315 ``restorecon -R -v /var/www/wallabag``
317 Du kannst deine Kontexte in einem Verzeichnis überprüfen, indem du ``ls -lZ`` tippst und alle deine aktuellen Regeln mit ``semanage fcontext -l -C`` überprüfst.
319 Wenn du das vorkonfigurierte latest-v2-package installierst, dann ist eine weitere Regel während der Installation nötig:
321 ``semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/wallabag/var"``
323 Nachdem du erfolgreich dein wallabag erreichst und die Installation fertiggestellt hast, kann dieser Kontext entfernt werden:
327 semanage fcontext -d -t httpd_sys_rw_content_t "/var/www/wallabag/var"
328 retorecon -R -v /var/www/wallabag/var