aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorNicolas Lœuillet <nicolas@loeuillet.org>2016-05-03 20:39:49 +0200
committerNicolas Lœuillet <nicolas@loeuillet.org>2016-05-03 20:39:49 +0200
commite546a2d6eb3075b4c13f22cc0957bfc96b8e14d9 (patch)
treef26904214e3efb6d7edeb1f8fceb3146de6996ce
parentbba9907d1ffe993da3bc9b7e6c87169953a11160 (diff)
downloadwallabag-e546a2d6eb3075b4c13f22cc0957bfc96b8e14d9.tar.gz
wallabag-e546a2d6eb3075b4c13f22cc0957bfc96b8e14d9.tar.zst
wallabag-e546a2d6eb3075b4c13f22cc0957bfc96b8e14d9.zip
Add LigHTTPd documentation
Fix #1931
-rw-r--r--docs/en/user/installation.rst41
-rw-r--r--docs/fr/user/installation.rst45
2 files changed, 82 insertions, 4 deletions
diff --git a/docs/en/user/installation.rst b/docs/en/user/installation.rst
index 3057373c..3872ad3a 100644
--- a/docs/en/user/installation.rst
+++ b/docs/en/user/installation.rst
@@ -91,7 +91,7 @@ If you changed the database configuration to use MySQL or PostgreSQL, you need t
91Installation with Docker 91Installation with Docker
92------------------------ 92------------------------
93 93
94We 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. 94We 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.
95 95
96Command to launch container 96Command to launch container
97~~~~~~~~~~~~~~~~~~~~~~~~~~~ 97~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -192,6 +192,45 @@ After reloading or restarting nginx, you should now be able to access wallabag a
192 192
193 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``. 193 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``.
194 194
195Configuration on LigHTTPd
196~~~~~~~~~~~~~~~~~~~~~~~~~
197
198Edit your ``lighttpd.conf`` file and paste this configuration into it:
199
200::
201
202 server.modules = (
203 "mod_fastcgi",
204 "mod_access",
205 "mod_alias",
206 "mod_compress",
207 "mod_redirect",
208 "mod_rewrite",
209 )
210 server.document-root = "/var/www/wallabag/web"
211 server.upload-dirs = ( "/var/cache/lighttpd/uploads" )
212 server.errorlog = "/var/log/lighttpd/error.log"
213 server.pid-file = "/var/run/lighttpd.pid"
214 server.username = "www-data"
215 server.groupname = "www-data"
216 server.port = 80
217 server.follow-symlink = "enable"
218 index-file.names = ( "index.php", "index.html", "index.lighttpd.html")
219 url.access-deny = ( "~", ".inc" )
220 static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" )
221 compress.cache-dir = "/var/cache/lighttpd/compress/"
222 compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" )
223 include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port
224 include_shell "/usr/share/lighttpd/create-mime.assign.pl"
225 include_shell "/usr/share/lighttpd/include-conf-enabled.pl"
226 dir-listing.activate = "disable"
227
228 url.rewrite-if-not-file = (
229 "^/([^?])(?:\?(.))?" => "/app.php?$1&$2",
230 "^/([^?]*)" => "/app.php?=$1",
231 "^/wiki$" => "/app.php",
232 )
233
195Rights access to the folders of the project 234Rights access to the folders of the project
196------------------------------------------- 235-------------------------------------------
197 236
diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst
index 4645ef74..9039d608 100644
--- a/docs/fr/user/installation.rst
+++ b/docs/fr/user/installation.rst
@@ -74,7 +74,7 @@ La configuration par défaut utilise SQLite pour la base de données. Si vous so
74 74
75Nous avons déjà créé un utilisateur : le login et le mot de passe sont ``wallabag``. 75Nous avons déjà créé un utilisateur : le login et le mot de passe sont ``wallabag``.
76 76
77.. 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). 77.. 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).
78 78
79Exécutez cette commande pour télécharger et décompresser l'archive : 79Exécutez cette commande pour télécharger et décompresser l'archive :
80 80
@@ -82,7 +82,7 @@ Exécutez cette commande pour télécharger et décompresser l'archive :
82 82
83 wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package 83 wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
84 84
85Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag. 85Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag.
86Si 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``. 86Si 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``.
87 87
88Installation avec Docker 88Installation avec Docker
@@ -189,6 +189,45 @@ Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir acc
189 189
190 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``. 190 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``.
191 191
192Configuration avec LigHTTPd
193~~~~~~~~~~~~~~~~~~~~~~~~~~~
194
195Éditez votre fichier ``lighttpd.conf`` collez-y cette configuration :
196
197::
198
199 server.modules = (
200 "mod_fastcgi",
201 "mod_access",
202 "mod_alias",
203 "mod_compress",
204 "mod_redirect",
205 "mod_rewrite",
206 )
207 server.document-root = "/var/www/wallabag/web"
208 server.upload-dirs = ( "/var/cache/lighttpd/uploads" )
209 server.errorlog = "/var/log/lighttpd/error.log"
210 server.pid-file = "/var/run/lighttpd.pid"
211 server.username = "www-data"
212 server.groupname = "www-data"
213 server.port = 80
214 server.follow-symlink = "enable"
215 index-file.names = ( "index.php", "index.html", "index.lighttpd.html")
216 url.access-deny = ( "~", ".inc" )
217 static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" )
218 compress.cache-dir = "/var/cache/lighttpd/compress/"
219 compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" )
220 include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port
221 include_shell "/usr/share/lighttpd/create-mime.assign.pl"
222 include_shell "/usr/share/lighttpd/include-conf-enabled.pl"
223 dir-listing.activate = "disable"
224
225 url.rewrite-if-not-file = (
226 "^/([^?])(?:\?(.))?" => "/app.php?$1&$2",
227 "^/([^?]*)" => "/app.php?=$1",
228 "^/wiki$" => "/app.php",
229 )
230
192Droits d'accès aux dossiers du projet 231Droits d'accès aux dossiers du projet
193------------------------------------- 232-------------------------------------
194 233
@@ -197,7 +236,7 @@ Environnement de test
197 236
198Quand 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. 237Quand 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.
199 238
200Environnement de production 239Environnement de production
201~~~~~~~~~~~~~~~~~~~~~~~~~~~ 240~~~~~~~~~~~~~~~~~~~~~~~~~~~
202 241
203Dè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. 242Dè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.