diff options
author | Nicolas Lœuillet <nicolas@loeuillet.org> | 2016-05-03 20:39:49 +0200 |
---|---|---|
committer | Nicolas Lœuillet <nicolas@loeuillet.org> | 2016-05-03 20:39:49 +0200 |
commit | e546a2d6eb3075b4c13f22cc0957bfc96b8e14d9 (patch) | |
tree | f26904214e3efb6d7edeb1f8fceb3146de6996ce | |
parent | bba9907d1ffe993da3bc9b7e6c87169953a11160 (diff) | |
download | wallabag-e546a2d6eb3075b4c13f22cc0957bfc96b8e14d9.tar.gz wallabag-e546a2d6eb3075b4c13f22cc0957bfc96b8e14d9.tar.zst wallabag-e546a2d6eb3075b4c13f22cc0957bfc96b8e14d9.zip |
Add LigHTTPd documentation
Fix #1931
-rw-r--r-- | docs/en/user/installation.rst | 41 | ||||
-rw-r--r-- | docs/fr/user/installation.rst | 45 |
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 | |||
91 | Installation with Docker | 91 | Installation with Docker |
92 | ------------------------ | 92 | ------------------------ |
93 | 93 | ||
94 | 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. | 94 | 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. |
95 | 95 | ||
96 | Command to launch container | 96 | Command 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 | ||
195 | Configuration on LigHTTPd | ||
196 | ~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
197 | |||
198 | Edit 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 | |||
195 | Rights access to the folders of the project | 234 | Rights 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 | ||
75 | Nous avons déjà créé un utilisateur : le login et le mot de passe sont ``wallabag``. | 75 | Nous 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 | ||
79 | Exécutez cette commande pour télécharger et décompresser l'archive : | 79 | Exé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 | ||
85 | Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag. | 85 | Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag. |
86 | 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``. | 86 | 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``. |
87 | 87 | ||
88 | Installation avec Docker | 88 | Installation 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 | ||
192 | Configuration 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 | |||
192 | Droits d'accès aux dossiers du projet | 231 | Droits d'accès aux dossiers du projet |
193 | ------------------------------------- | 232 | ------------------------------------- |
194 | 233 | ||
@@ -197,7 +236,7 @@ Environnement de test | |||
197 | 236 | ||
198 | 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. | 237 | 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. |
199 | 238 | ||
200 | Environnement de production | 239 | Environnement de production |
201 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 240 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
202 | 241 | ||
203 | 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. | 242 | 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. |