X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=docs%2Ffr%2Fuser%2Finstallation.rst;h=8682d38605662b2aecef6dc5fae228c48882af4d;hb=9ddf49ba2468f40f99e1972e183ed81c2dbcaa3a;hp=3c647aac0ff4dcae0c1dbd2998b22a8b0bf9fa05;hpb=7eccbda99f16dc39ee01a0c81ab88293e9b268fd;p=github%2Fwallabag%2Fwallabag.git diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst index 3c647aac..8682d386 100644 --- a/docs/fr/user/installation.rst +++ b/docs/fr/user/installation.rst @@ -48,7 +48,7 @@ Pour installer wallabag, vous devez exécuter ces deux commandes : git clone https://github.com/wallabag/wallabag.git cd wallabag - git checkout 2.0.1 + git checkout 2.0.3 SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist php bin/console wallabag:install --env=prod @@ -148,6 +148,34 @@ En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallab Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. + .. note:: 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``. + + +Droits d'accès aux dossiers du projet +------------------------------------- + + +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 à accès naturellement au repertoire courant, tout va bien. + + +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 fourni par le projet. + +Aussi, le dossier, connu sous le nom de ``DocumentRoot`` (pour apache) ou ``root`` (pour Nginx), doit être impérativement accessible par l'utilisateur de Apache ou Nginx. Le nom de cet utilisateur est généralement ``www-data``, ``apache`` ou ``nobody`` (selon les systèmes linux utilisés). + +Donc le dossier ``/var/www/wallabag/web`` doit être accessible par ce dernier. Mais cela ne suffira pas si nous nous contentons de ce dossier, et nous pourrions avoir, au mieux une page blanche en accédant à la page d'accueil du projet, au pire une erreur 500. + +Cela est dû au fait qu'il faut aussi octroyer les mêmes droits d'accès au dossier ``/var/www/wallabag/var`` que ceux octroyés au dossier ``/var/www/wallabag/web``. Ainsi, on règle le problème par la commande suivante : + +.. code-block:: bash + + chown -R www-data:www-data /var/www/wallabag/var +