From de0ab52a47ea91f7013d0cacd7240ecdc85026ed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Tue, 28 Mar 2017 11:45:40 +0200 Subject: Updated requirements in documentation --- docs/de/user/installation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de/user/installation.rst') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index cec62d18..1b7f0dee 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -4,7 +4,7 @@ Installation von wallabag Voraussetzungen --------------- -wallabag ist kompatibel mit PHP >= 5.5, inkl. PHP 7. +wallabag ist kompatibel mit **PHP >= 5.6**, inkl. PHP 7. .. note:: -- cgit v1.2.3 From 3ea184ffc07e8f6c7e5b3f0bbaddedf6e312f617 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Wed, 29 Mar 2017 12:31:52 +0200 Subject: Added :fr: and :it: translations for Cloudron --- docs/de/user/installation.rst | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'docs/de/user/installation.rst') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 0de6b6de..6dc4e669 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -105,6 +105,14 @@ Kommando, um den Container zu starten docker pull wallabag/wallabag +Installation on Cloudron +~~~~~~~~~~~~~~~~~~~~~~~~ + +Cloudron provides an easy way to install webapps on your server with a focus on sysadmin automation and keeping apps updated. +wallabag is packaged as a Cloudron app and available to install directly from the store. + +`Install wallabag on your Cloudron `__ + Virtualhosts ------------ -- cgit v1.2.3 From 106e0160f25a8fafa1f13c8fc5d96328f17cd1c0 Mon Sep 17 00:00:00 2001 From: Johannes Zellner Date: Wed, 29 Mar 2017 14:16:04 +0200 Subject: Added :de: translation for Cloudron --- docs/de/user/installation.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'docs/de/user/installation.rst') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 6dc4e669..2e8d8343 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -105,13 +105,13 @@ Kommando, um den Container zu starten docker pull wallabag/wallabag -Installation on Cloudron +Cloudron Installation ~~~~~~~~~~~~~~~~~~~~~~~~ -Cloudron provides an easy way to install webapps on your server with a focus on sysadmin automation and keeping apps updated. -wallabag is packaged as a Cloudron app and available to install directly from the store. +Cloudron bietet einfache Webapp Installation auf deinem Server, mit Fokus auf System Administrator Automatisierung und Updates. +Ein Wallabag Paket ist direkt zur Installation durch den Cloudron Store verfügbar. -`Install wallabag on your Cloudron `__ +`Installiere wallabag auf deinem Cloudron `__ Virtualhosts ------------ -- cgit v1.2.3 From 56f9a60f49af8e23d56bdbe0b65dd629226af25a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Wed, 3 May 2017 15:54:56 +0200 Subject: Fixed old links in documentation --- docs/de/user/installation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de/user/installation.rst') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 403ff6e0..7dd489b1 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -88,7 +88,7 @@ Führe dieses Kommando aus, um das neueste Paket herunterzuladen und zu entpacke wget https://wllbg.org/latest-v2-package && tar xvf latest-v2-package -Du findest die `md5 Hashsumme des neuesten Pakets auf unserer Website `_. +Du findest die `md5 Hashsumme des neuesten Pakets auf unserer Website `_. Jetzt lies die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf dein wallabag zu. 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``. -- cgit v1.2.3 From 322c270b6590d0d0bf5025f4782ffe7cdea0f8b0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Tue, 16 May 2017 13:09:40 +0200 Subject: Removed embedded documentation --- docs/de/user/installation.rst | 349 ------------------------------------------ 1 file changed, 349 deletions(-) delete mode 100644 docs/de/user/installation.rst (limited to 'docs/de/user/installation.rst') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst deleted file mode 100644 index 7dd489b1..00000000 --- a/docs/de/user/installation.rst +++ /dev/null @@ -1,349 +0,0 @@ -Installation von wallabag -========================= - -Voraussetzungen ---------------- - -wallabag ist kompatibel mit **PHP >= 5.6**, inkl. PHP 7. - -.. note:: - - To install wallabag easily, we create a ``Makefile``, so you need to have the ``make`` tool. - -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. - -Composer installieren: - -:: - - curl -s https://getcomposer.org/installer | php - -Du kannst eine spezifische Anleitung `hier `__ finden. - -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 -nicht alle folgenden Pakete installieren. - -- php-session -- php-ctype -- php-dom -- php-hash -- php-simplexml -- php-json -- php-gd -- php-mbstring -- php-xml -- php-tidy -- php-iconv -- php-curl -- php-gettext -- php-tokenizer -- php-bcmath - -wallabag nutzt PDO, um sich mit der Datenbank zu verbinden, darum benötigst du eines der folgenden Komponenten: - -- pdo_mysql -- pdo_sqlite -- pdo_pgsql - -und dessen dazugehörigen Datenbankserver. - -Installation ------------- - -Auf einem dedizierten Webserver (empfohlener Weg) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen: - -:: - - git clone https://github.com/wallabag/wallabag.git - cd wallabag && make install - -Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen: - -:: - - make run - -und wallabag unter http://deineserverip:8000 erreichen. - -.. tip:: - - 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 `__ werfen. - -Auf einem geteilten Webhosting -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Wir stellen ein Paket inkl. aller Abhängigkeiten bereit. -Die Standardkonfiguration nutzt SQLite für die Datenbank. Wenn du diese Einstellung ändern willst, ändere bitte ``app/config/parameters.yml``. - -Wir haben bereits einen Nutzer erstellt: Login und Passwort sind ``wallabag``. - -.. 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). - -Führe dieses Kommando aus, um das neueste Paket herunterzuladen und zu entpacken: - -.. code-block:: bash - - wget https://wllbg.org/latest-v2-package && tar xvf latest-v2-package - -Du findest die `md5 Hashsumme des neuesten Pakets auf unserer Website `_. - -Jetzt lies die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf dein wallabag zu. -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``. - -Installation mit Docker -~~~~~~~~~~~~~~~~~~~~~~~ - -Wir stellen ein Docker Image zu Verfügung, um wallabag einfach zu installieren. Schaue in unser Repository in unserem `Docker Hub `__, um mehr Informationen zu erhalten. - -Kommando, um den Container zu starten -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. code-block:: bash - - docker pull wallabag/wallabag - -Cloudron Installation -~~~~~~~~~~~~~~~~~~~~~~~~ - -Cloudron bietet einfache Webapp Installation auf deinem Server, mit Fokus auf System Administrator Automatisierung und Updates. -Ein Wallabag Paket ist direkt zur Installation durch den Cloudron Store verfügbar. - -`Installiere wallabag auf deinem Cloudron `__ - -Virtualhosts ------------- - -Konfiguration von Apache -~~~~~~~~~~~~~~~~~~~~~~~~ - -Vergiss nicht, die *rewrite* mod von Apache zu aktivieren. - -.. code-block:: bash - - a2enmod rewrite && systemctl reload apache2 - -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: - -:: - - - ServerName domain.tld - ServerAlias www.domain.tld - - DocumentRoot /var/www/wallabag/web - - AllowOverride None - Order Allow,Deny - Allow from All - - - Options -MultiViews - RewriteEngine On - RewriteCond %{REQUEST_FILENAME} !-f - RewriteRule ^(.*)$ app.php [QSA,L] - - - - # uncomment the following lines if you install assets as symlinks - # or run into problems when compiling LESS/Sass/CoffeScript assets - # - # Options FollowSymlinks - # - - # optionally disable the RewriteEngine for the asset directories - # which will allow apache to simply reply with a 404 when files are - # not found instead of passing the request into the full symfony stack - - - RewriteEngine Off - - - ErrorLog /var/log/apache2/wallabag_error.log - CustomLog /var/log/apache2/wallabag_access.log combined - - -Nach dem du Apache neugeladen oder neugestartet hast, solltest du nun wallabag unter http://domain.tld erreichen. - -Konfiguration von Nginx -~~~~~~~~~~~~~~~~~~~~~~~ - -Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren, dann ist hier ein Rezept für wallabag: - -:: - - server { - server_name domain.tld www.domain.tld; - root /var/www/wallabag/web; - - location / { - # try to serve file directly, fallback to app.php - try_files $uri /app.php$is_args$args; - } - location ~ ^/app\.php(/|$) { - fastcgi_pass unix:/var/run/php5-fpm.sock; - fastcgi_split_path_info ^(.+\.php)(/.*)$; - include fastcgi_params; - # When you are using symlinks to link the document root to the - # current version of your application, you should pass the real - # application path instead of the path to the symlink to PHP - # FPM. - # Otherwise, PHP's OPcache may not properly detect changes to - # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126 - # for more information). - fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; - fastcgi_param DOCUMENT_ROOT $realpath_root; - # Prevents URIs that include the front controller. This will 404: - # http://domain.tld/app.php/some-path - # Remove the internal directive to allow URIs like this - internal; - } - - # return 404 for all other php files not matching the front controller - # this prevents access to other php files you don't want to be accessible. - location ~ \.php$ { - return 404; - } - - error_log /var/log/nginx/wallabag_error.log; - access_log /var/log/nginx/wallabag_access.log; - } - -Nach dem Neuladen oder Neustarten von nginx solltest du nun wallabag unter http://domain.tld erreichen. - -.. tip:: - - 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``. - -Konfiguration von lighttpd -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -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): - -:: - - server.modules = ( - "mod_fastcgi", - "mod_access", - "mod_alias", - "mod_compress", - "mod_redirect", - "mod_rewrite", - ) - server.document-root = "/var/www/wallabag/web" - server.upload-dirs = ( "/var/cache/lighttpd/uploads" ) - server.errorlog = "/var/log/lighttpd/error.log" - server.pid-file = "/var/run/lighttpd.pid" - server.username = "www-data" - server.groupname = "www-data" - server.port = 80 - server.follow-symlink = "enable" - index-file.names = ( "index.php", "index.html", "index.lighttpd.html") - url.access-deny = ( "~", ".inc" ) - static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" ) - compress.cache-dir = "/var/cache/lighttpd/compress/" - compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" ) - include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port - include_shell "/usr/share/lighttpd/create-mime.assign.pl" - include_shell "/usr/share/lighttpd/include-conf-enabled.pl" - dir-listing.activate = "disable" - - url.rewrite-if-not-file = ( - "^/([^?]*)(?:\?(.*))?" => "/app.php?$1&$2", - "^/([^?]*)" => "/app.php?=$1", - ) - -Rechte, um das Projektverzeichnis zu betreten ---------------------------------------------- - -Testumgebung -~~~~~~~~~~~~ - -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. - -Produktionsumgebung -~~~~~~~~~~~~~~~~~~~ - -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. - -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). - -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. - -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: - -.. code-block:: bash - - chown -R www-data:www-data /var/www/wallabag/var - -Es muss analog für die folgenden Ordner ausgeführt werden - -* /var/www/wallabag/bin/ -* /var/www/wallabag/app/config/ -* /var/www/wallabag/vendor/ -* /var/www/wallabag/data/ - -durch Eingabe der Kommandos - -.. code-block:: bash - - chown -R www-data:www-data /var/www/wallabag/bin - chown -R www-data:www-data /var/www/wallabag/app/config - chown -R www-data:www-data /var/www/wallabag/vendor - chown -R www-data:www-data /var/www/wallabag/data/ - -ansonsten wirst du früher oder später folgenden Fehlermeldung sehen: - -.. code-block:: bash - - Unable to write to the "bin" directory. - file_put_contents(app/config/parameters.yml): failed to open stream: Permission denied - file_put_contents(/.../wallabag/vendor/autoload.php): failed to open stream: Permission denied - -Zusätzliche Regeln für SELinux -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -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: - -``getenforce`` - -Dies wird ``Enforcing`` ausgeben, wenn SELinux aktiviert ist. Einen neuen Kontext zu erstellen, erfordert die folgende Syntax: - -``semanage fcontext -a -t `` - -Zum Beispiel: - -``semanage fcontext -a -t httpd_sys_content_t "/var/www/wallabag(/.*)?"`` - -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: - -+-----------------------------------+----------------------------+ -| Vollständiger Pfad | Kontext | -+===================================+============================+ -| /var/www/wallabag(/.*)? | ``httpd_sys_content_t`` | -+-----------------------------------+----------------------------+ -| /var/www/wallabag/data(/.*)? | ``httpd_sys_rw_content_t`` | -+-----------------------------------+----------------------------+ -| /var/www/wallabag/var/logs(/.*)? | ``httpd_log_t`` | -+-----------------------------------+----------------------------+ -| /var/www/wallabag/var/cache(/.*)? | ``httpd_cache_t`` | -+-----------------------------------+----------------------------+ - -Nach dem diese Kontexte erstellt wurden, tippe das folgende, um deine Regeln anzuwenden: - -``restorecon -R -v /var/www/wallabag`` - -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. - -Wenn du das vorkonfigurierte latest-v2-package installierst, dann ist eine weitere Regel während der Installation nötig: - -``semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/wallabag/var"`` - -Nachdem du erfolgreich dein wallabag erreichst und die Installation fertiggestellt hast, kann dieser Kontext entfernt werden: - -:: - - semanage fcontext -d -t httpd_sys_rw_content_t "/var/www/wallabag/var" - retorecon -R -v /var/www/wallabag/var -- cgit v1.2.3