docs/de/user/installation.rst

   1 Installation von wallabag
   2 =========================
   3
   4 Voraussetzungen
   5 ---------------
   6
   7 wallabag ist kompatibel mit PHP >= 5.5, inkl. PHP 7.
   8
   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.
  11
  12 - php-session
  13 - php-ctype
  14 - php-dom
  15 - php-hash
  16 - php-simplexml
  17 - php-json
  18 - php-gd
  19 - php-mbstring
  20 - php-xml
  21 - php-tidy
  22 - php-iconv
  23 - php-curl
  24 - php-gettext
  25 - php-tokenizer
  26 - php-bcmath
  27
  28 wallabag nutzt PDO, um sich mit der Datenbank zu verbinden, darum benötigst du eines der folgenden Komponenten:
  29
  30 - pdo_mysql
  31 - pdo_sqlite
  32 - pdo_pgsql
  33
  34 und dessen dazugehörigen Datenbankserver.
  35
  36 Installation
  37 ------------
  38
  39 Auf einem dedizierten Webserver (empfohlener Weg)
  40 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  41
  42 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
  44 Composer installieren:
  45
  46 ::
  47
  48     curl -s http://getcomposer.org/installer | php
  49
  50 Du kannst eine spezifische Anleitung `hier <https://getcomposer.org/doc/00-intro.md>`__ finden.
  51
  52 Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen:
  53
  54 ::
  55
  56     git clone https://github.com/wallabag/wallabag.git
  57     cd wallabag
  58     git checkout 2.1.0
  59     SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
  60     php bin/console wallabag:install --env=prod
  61
  62 Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen:
  63
  64 ::
  65
  66     php bin/console server:run --env=prod
  67
  68 Und wallabag unter http://deineserverip:8000 erreichen
  69
  70 .. tip::
  71
  72     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
  74 Auf einem geteilten Webhosting
  75 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  76
  77 Wir stellen ein Paket inkl. aller Abhängigkeiten bereit.
  78 Die Standardkonfiguration nutzt SQLite für die Datenbank. Wenn du diese Einstellung ändern willst, ändere bitte ``app/config/parameters.yml``.
  79
  80 Wir haben bereits einen Nutzer erstellt: Login und Passwort sind ``wallabag``.
  81
  82 .. 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
  84 Führe dieses Kommando aus, um das neueste Paket herunterzuladen und zu entpacken:
  85
  86 .. code-block:: bash
  87
  88     wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
  89
  90 (md5 hash: ``6c33520e29cc754b687f9cee0398dede``)
  91
  92 Jetzt lese die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf dein wallabag zu.
  93 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
  95 Installation mit Docker
  96 ------------------------
  97
  98 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
 100 Kommando, um den Container zu starten
 101 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 102
 103 .. code-block:: bash
 104
 105     docker pull wallabag/wallabag
 106
 107 Virtualhosts
 108 ------------
 109
 110 Konfiguration von Apache
 111 ~~~~~~~~~~~~~~~~~~~~~~~
 112
 113 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:
 114
 115 ::
 116
 117     <VirtualHost *:80>
 118         ServerName domain.tld
 119         ServerAlias www.domain.tld
 120
 121         DocumentRoot /var/www/wallabag/web
 122         <Directory /var/www/wallabag/web>
 123             AllowOverride None
 124             Order Allow,Deny
 125             Allow from All
 126
 127             <IfModule mod_rewrite.c>
 128                 Options -MultiViews
 129                 RewriteEngine On
 130                 RewriteCond %{REQUEST_FILENAME} !-f
 131                 RewriteRule ^(.*)$ app.php [QSA,L]
 132             </IfModule>
 133         </Directory>
 134
 135         # uncomment the following lines if you install assets as symlinks
 136         # or run into problems when compiling LESS/Sass/CoffeScript assets
 137         # <Directory /var/www/wallabag>
 138         #     Options FollowSymlinks
 139         # </Directory>
 140
 141         # optionally disable the RewriteEngine for the asset directories
 142         # which will allow apache to simply reply with a 404 when files are
 143         # not found instead of passing the request into the full symfony stack
 144         <Directory /var/www/wallabag/web/bundles>
 145             <IfModule mod_rewrite.c>
 146                 RewriteEngine Off
 147             </IfModule>
 148         </Directory>
 149         ErrorLog /var/log/apache2/wallabag_error.log
 150         CustomLog /var/log/apache2/wallabag_access.log combined
 151     </VirtualHost>
 152
 153 Nach dem du Apache neugeladen oder neugestartet hast, solltest du nun wallabag unter http://domain.tld erreichen.
 154
 155 Konfiguration von Nginx
 156 ~~~~~~~~~~~~~~~~~~~~~~~
 157
 158 Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren, dann ist hier ein Rezept für wallabag:
 159
 160 ::
 161
 162     server {
 163         server_name domain.tld www.domain.tld;
 164         root /var/www/wallabag/web;
 165
 166         location / {
 167             # try to serve file directly, fallback to app.php
 168             try_files $uri /app.php$is_args$args;
 169         }
 170         location ~ ^/app\.php(/|$) {
 171             fastcgi_pass unix:/var/run/php5-fpm.sock;
 172             fastcgi_split_path_info ^(.+\.php)(/.*)$;
 173             include fastcgi_params;
 174             # When you are using symlinks to link the document root to the
 175             # current version of your application, you should pass the real
 176             # application path instead of the path to the symlink to PHP
 177             # FPM.
 178             # Otherwise, PHP's OPcache may not properly detect changes to
 179             # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
 180             # for more information).
 181             fastcgi_param  SCRIPT_FILENAME  $realpath_root$fastcgi_script_name;
 182             fastcgi_param DOCUMENT_ROOT $realpath_root;
 183             # Prevents URIs that include the front controller. This will 404:
 184             # http://domain.tld/app.php/some-path
 185             # Remove the internal directive to allow URIs like this
 186             internal;
 187         }
 188
 189         error_log /var/log/nginx/wallabag_error.log;
 190         access_log /var/log/nginx/wallabag_access.log;
 191     }
 192
 193 Nach dem neuladen oder neustarten von nginx, solltest du nun wallabag unter http://domain.tld erreichen.
 194
 195 .. tip::
 196
 197     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``.
 198     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
 200 Konfiguration von lighttpd
 201 ~~~~~~~~~~~~~~~~~~~~~~~~~
 202
 203 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):
 204
 205 ::
 206
 207     server.modules = (
 208         "mod_fastcgi",
 209         "mod_access",
 210         "mod_alias",
 211         "mod_compress",
 212         "mod_redirect",
 213         "mod_rewrite",
 214     )
 215     server.document-root = "/var/www/wallabag/web"
 216     server.upload-dirs = ( "/var/cache/lighttpd/uploads" )
 217     server.errorlog = "/var/log/lighttpd/error.log"
 218     server.pid-file = "/var/run/lighttpd.pid"
 219     server.username = "www-data"
 220     server.groupname = "www-data"
 221     server.port = 80
 222     server.follow-symlink = "enable"
 223     index-file.names = ( "index.php", "index.html", "index.lighttpd.html")
 224     url.access-deny = ( "~", ".inc" )
 225     static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" )
 226     compress.cache-dir = "/var/cache/lighttpd/compress/"
 227     compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" )
 228     include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port
 229     include_shell "/usr/share/lighttpd/create-mime.assign.pl"
 230     include_shell "/usr/share/lighttpd/include-conf-enabled.pl"
 231     dir-listing.activate = "disable"
 232
 233     url.rewrite-if-not-file = (
 234         "^/([^?]*)(?:\?(.*))?" => "/app.php?$1&$2",
 235         "^/([^?]*)" => "/app.php?=$1",
 236     )
 237
 238 Rechte, um das Projektverzeichnis zu betreten
 239 ---------------------------------------------
 240
 241 Testumgebung
 242 ~~~~~~~~~~~~
 243
 244 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.
 245
 246 Produktionsumgebung
 247 ~~~~~~~~~~~~~~~~~~~
 248
 249 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
 251 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
 253 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
 255 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:
 256
 257 .. code-block:: bash
 258
 259    chown -R www-data:www-data /var/www/wallabag/var
 260
 261 Es muss analog für die folgenden Ordner ausgeführt werden
 262
 263 * /var/www/wallabag/bin/
 264 * /var/www/wallabag/app/config/
 265 * /var/www/wallabag/vendor/
 266 * /var/www/wallabag/data/
 267
 268 durch Eingabe der Kommandos
 269
 270 .. code-block:: bash
 271
 272    chown -R www-data:www-data /var/www/wallabag/bin
 273    chown -R www-data:www-data /var/www/wallabag/app/config
 274    chown -R www-data:www-data /var/www/wallabag/vendor
 275    chown -R www-data:www-data /var/www/wallabag/data/
 276
 277 ansonsten wirst du früher oder später folgenden Fehlermeldung sehen:
 278
 279 .. code-block:: bash
 280
 281     Unable to write to the "bin" directory.
 282     file_put_contents(app/config/parameters.yml): failed to open stream: Permission denied
 283     file_put_contents(/.../wallabag/vendor/autoload.php): failed to open stream: Permission denied
 284
 285 Zusätzliche Regeln für SELinux
 286 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 287
 288 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:
 289
 290 ``getenforce``
 291
 292 Dies wird ``Enforcing`` ausgeben, wenn SELinux aktiviert ist. Einen neuen Kontext zu erstellen, erfordert die folgende Syntax:
 293
 294 ``semanage fcontext -a -t <context type> <full path>``
 295
 296 Zum Beispiel:
 297
 298 ``semanage fcontext -a -t httpd_sys_content_t "/var/www/wallabag(/.*)?"``
 299
 300 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 +-----------------------------------+----------------------------+
 303 | Vollständiger Pfad                | Kontext                    |
 304 +===================================+============================+
 305 | /var/www/wallabag(/.*)?           | ``httpd_sys_content_t``    |
 306 +-----------------------------------+----------------------------+
 307 | /var/www/wallabag/data(/.*)?      | ``httpd_sys_rw_content_t`` |
 308 +-----------------------------------+----------------------------+
 309 | /var/www/wallabag/var/logs(/.*)?  | ``httpd_log_t``            |
 310 +-----------------------------------+----------------------------+
 311 | /var/www/wallabag/var/cache(/.*)? | ``httpd_cache_t``          |
 312 +-----------------------------------+----------------------------+
 313
 314 Nach dem diese Kontexte erstellt wurden, tippe das folgende, um deine Regeln anzuwenden:
 315
 316 ``restorecon -R -v /var/www/wallabag``
 317
 318 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
 320 Wenn du das vorkonfigurierte latest-v2-package installierst, dann ist eine weitere Regel während der Installation nötig:
 321
 322 ``semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/wallabag/var"``
 323
 324 Nachdem du erfolgreich dein wallabag erreichst und die Installation fertiggestellt hast, kann dieser Kontext entfernt werden:
 325
 326 ::
 327
 328     semanage fcontext -d -t httpd_sys_rw_content_t "/var/www/wallabag/var"
 329     retorecon -R -v /var/www/wallabag/var