diff options
Diffstat (limited to 'docs/fr/user/installation.rst')
-rw-r--r-- | docs/fr/user/installation.rst | 94 |
1 files changed, 82 insertions, 12 deletions
diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst index 33a2cf5c..8f2ae25d 100644 --- a/docs/fr/user/installation.rst +++ b/docs/fr/user/installation.rst | |||
@@ -32,6 +32,9 @@ wallabag utilise PDO afin de se connecter à une base de données, donc vous aur | |||
32 | Installation | 32 | Installation |
33 | ------------ | 33 | ------------ |
34 | 34 | ||
35 | Sur un serveur dédié (méthode conseillée) | ||
36 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
37 | |||
35 | wallabag utilise un grand nombre de bibliothèques pour fonctionner. Ces bibliothèques doivent être installées à l'aide d'un outil nommé Composer. Vous devez l'installer si ce n'est déjà fait. | 38 | wallabag utilise un grand nombre de bibliothèques pour fonctionner. Ces bibliothèques doivent être installées à l'aide d'un outil nommé Composer. Vous devez l'installer si ce n'est déjà fait. |
36 | 39 | ||
37 | Installation de Composer : | 40 | Installation de Composer : |
@@ -60,13 +63,47 @@ Pour démarrer le serveur interne à php et vérifier que tout s'est installé c | |||
60 | 63 | ||
61 | Et accéder wallabag à l'adresse http://lipdevotreserveur:8000 | 64 | Et accéder wallabag à l'adresse http://lipdevotreserveur:8000 |
62 | 65 | ||
63 | .. note:: | 66 | .. tip:: |
64 | Pour définir des paramètres via des variables d'environnement, vous pouvez les spécifier avec le préfixe ``SYMFONY__``. Par exemple, ``SYMFONY__DATABASE_DRIVER``. Vous pouvez lire `documentation Symfony <http://symfony.com/doc/current/cookbook/configuration/external_parameters.html>`__ pour en savoir plus. | 67 | Pour définir des paramètres via des variables d'environnement, vous pouvez les spécifier avec le préfixe ``SYMFONY__``. Par exemple, ``SYMFONY__DATABASE_DRIVER``. Vous pouvez lire `documentation Symfony <http://symfony.com/doc/current/cookbook/configuration/external_parameters.html>`__ pour en savoir plus. |
65 | 68 | ||
66 | Installation avec Apache | 69 | Sur un serveur mutualisé |
70 | ~~~~~~~~~~~~~~~~~~~~~~~~ | ||
71 | |||
72 | Nous mettons à votre disposition une archive avec toutes les dépendances à l'intérieur. | ||
73 | La configuration par défaut utilise SQLite pour la base de données. Si vous souhaitez changer ces paramètres, vous devez modifier le fichier ``app/config/parameters.yml``. | ||
74 | |||
75 | Nous avons déjà créé un utilisateur : le login et le mot de passe sont ``wallabag``. | ||
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). | ||
78 | |||
79 | Exécutez cette commande pour télécharger et décompresser l'archive : | ||
80 | |||
81 | .. code-block:: bash | ||
82 | |||
83 | wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package | ||
84 | |||
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``. | ||
87 | |||
88 | Installation avec Docker | ||
67 | ------------------------ | 89 | ------------------------ |
68 | 90 | ||
69 | En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallabag et que vous utilisiez php comme un module Apache, voici un vhost pour wallabag : | 91 | Nous vous proposons une image Docker pour installer wallabag facilement. Allez voir du côté de `Docker Hub <https://hub.docker.com/r/wallabag/wallabag/>`__ pour plus d'informations. |
92 | |||
93 | Commande pour démarrer le containeur | ||
94 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
95 | |||
96 | .. code-block:: bash | ||
97 | |||
98 | docker pull wallabag/wallabag | ||
99 | |||
100 | Virtual hosts | ||
101 | ------------- | ||
102 | |||
103 | Configuration avec Apache | ||
104 | ~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
105 | |||
106 | En imaginant que vous vouliez installer wallabag dans le dossier ``/var/www/wallabag`` et que vous utilisiez PHP comme un module Apache, voici un vhost pour wallabag : | ||
70 | 107 | ||
71 | :: | 108 | :: |
72 | 109 | ||
@@ -108,10 +145,10 @@ En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallab | |||
108 | 145 | ||
109 | Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. | 146 | Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. |
110 | 147 | ||
111 | Installation avec Nginx | 148 | Configuration avec Nginx |
112 | ----------------------- | 149 | ~~~~~~~~~~~~~~~~~~~~~~~~ |
113 | 150 | ||
114 | En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallabag, voici un fichier de configuration Nginx pour wallabag : | 151 | En imaginant que vous vouliez installer wallabag dans le dossier ``/var/www/wallabag``, voici un fichier de configuration Nginx pour wallabag : |
115 | 152 | ||
116 | :: | 153 | :: |
117 | 154 | ||
@@ -148,23 +185,57 @@ En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallab | |||
148 | 185 | ||
149 | Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. | 186 | Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. |
150 | 187 | ||
151 | 188 | .. tip:: | |
152 | .. note:: | ||
153 | 189 | ||
154 | 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``. |
155 | 191 | ||
192 | Configuration avec lighttpd | ||
193 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
194 | |||
195 | En imaginant que vous vouliez installer wallabag dans le dossier ``/var/www/wallabag``, voici un fichier de configuration pour wallabag (é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 | ) | ||
156 | 229 | ||
157 | Droits d'accès aux dossiers du projet | 230 | Droits d'accès aux dossiers du projet |
158 | ------------------------------------- | 231 | ------------------------------------- |
159 | 232 | ||
160 | |||
161 | Environnement de test | 233 | Environnement de test |
162 | ~~~~~~~~~~~~~~~~~~~~~ | 234 | ~~~~~~~~~~~~~~~~~~~~~ |
163 | 235 | ||
164 | 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. | 236 | 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. |
165 | 237 | ||
166 | 238 | Environnement de production | |
167 | Environnement de production | ||
168 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 239 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
169 | 240 | ||
170 | 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. | 241 | 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. |
@@ -178,4 +249,3 @@ Cela est dû au fait qu'il faut aussi octroyer les mêmes droits d'accès au dos | |||
178 | .. code-block:: bash | 249 | .. code-block:: bash |
179 | 250 | ||
180 | chown -R www-data:www-data /var/www/wallabag/var | 251 | chown -R www-data:www-data /var/www/wallabag/var |
181 | |||