]> git.immae.eu Git - github/wallabag/wallabag.git/commitdiff
Add LigHTTPd documentation
authorNicolas Lœuillet <nicolas@loeuillet.org>
Tue, 3 May 2016 18:39:49 +0000 (20:39 +0200)
committerNicolas Lœuillet <nicolas@loeuillet.org>
Tue, 3 May 2016 18:39:49 +0000 (20:39 +0200)
Fix #1931

docs/en/user/installation.rst
docs/fr/user/installation.rst

index 3057373c281f282ea358b10f9358528bd4ee84bb..3872ad3aa7ba194d7aeaaa008d4c2535dcd959d6 100644 (file)
@@ -91,7 +91,7 @@ If you changed the database configuration to use MySQL or PostgreSQL, you need t
 Installation with Docker
 ------------------------
 
-We provide you a Docker image to install wallabag easily. Have a look to our repository on `Docker Hub <https://hub.docker.com/r/wallabag/wallabag/>`__ to have more information. 
+We provide you a Docker image to install wallabag easily. Have a look to our repository on `Docker Hub <https://hub.docker.com/r/wallabag/wallabag/>`__ to have more information.
 
 Command to launch container
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -192,6 +192,45 @@ After reloading or restarting nginx, you should now be able to access wallabag a
 
     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``.
 
+Configuration on LigHTTPd
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Edit your ``lighttpd.conf`` file and paste this configuration into it:
+
+::
+
+    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",
+    "^/wiki$" => "/app.php",
+    )
+
 Rights access to the folders of the project
 -------------------------------------------
 
index 4645ef74ca8743da287b67684376a95982081ed8..9039d608d1b96306d50edd0e1d9a018d94e3de90 100644 (file)
@@ -74,7 +74,7 @@ La configuration par défaut utilise SQLite pour la base de données. Si vous so
 
 Nous avons déjà créé un utilisateur : le login et le mot de passe sont ``wallabag``.
 
-.. caution:: Avec cette archive, wallabag ne vérifie pas si les extensions obligatoires sont présentes sur votre serveur pour bien fonctionner (ces vérifications sont faites durant le ``composer install`` quand vous avez un serveur dédié, voir ci-dessus). 
+.. caution:: Avec cette archive, wallabag ne vérifie pas si les extensions obligatoires sont présentes sur votre serveur pour bien fonctionner (ces vérifications sont faites durant le ``composer install`` quand vous avez un serveur dédié, voir ci-dessus).
 
 Exécutez cette commande pour télécharger et décompresser l'archive :
 
@@ -82,7 +82,7 @@ Exécutez cette commande pour télécharger et décompresser l'archive :
 
     wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
 
-Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag. 
+Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag.
 Si vous avez changé la configuration pour modifier le type de stockage (MySQL ou PostgreSQL), vous devrez vous créer un utilisateur via la commande ``php bin/console wallabag:install --env=prod``.
 
 Installation avec Docker
@@ -189,6 +189,45 @@ Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir acc
 
     Si vous voulez importer un fichier important dans wallabag, vous devez ajouter cette ligne dans votre configuration nginx ``client_max_body_size XM; # allows file uploads up to X megabytes``.
 
+Configuration avec LigHTTPd
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Éditez votre fichier ``lighttpd.conf`` collez-y cette configuration :
+
+::
+
+    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",
+    "^/wiki$" => "/app.php",
+    )
+
 Droits d'accès aux dossiers du projet
 -------------------------------------
 
@@ -197,7 +236,7 @@ Environnement de test
 
 Quand nous souhaitons juste tester wallabag, nous lançons simplement la commande  ``php bin/console server:run --env=prod`` pour démarrer l'instance wallabag et tout se passe correctement car l'utilisateur qui a démarré le projet a accès naturellement au repertoire courant, tout va bien.
 
-Environnement de production 
+Environnement de production
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Dès lors que nous utilisons Apache ou Nginx pour accéder à notre instance wallabag, et non plus la commande ``php bin/console server:run --env=prod`` pour la démarrer, il faut prendre garde à octroyer les bons droits aux bons dossiers afin de préserver la sécurité de l'ensemble des fichiers fournis par le projet.