1 files changed, 64 insertions, 0 deletions
diff --git a/docs/fr/source/installation.rst b/docs/fr/source/installation.rst
new file mode 100644
index 000000000..c7093930a
--- /dev/null
+++ b/docs/fr/source/installation.rst
@@ -0,0 +1,64 @@
+.. -*- coding: utf-8 -*-
+
+============
+Installation
+============
+
+:Auteur: Étienne Loks
+:Date: 2016-06-09
+:Copyright: CC-BY 3.0
+
+Ce document présente les instructions d'installation d'Ishtar.
+
+Pour l'instant, elles se limitent à l'installation sous Debian GNU/linux via le paquet Debian.
+
+.. note:: Sauf mention explicite, chaque commande est exécutée en tant qu'utilisateur root. Les utilisateurs de sudo l'ajouteront à chaque commande faite.
+
+.. contents::
+
+Installation sur poste Debian Wheezy
+------------------------------------
+
+Un dépôt a été mis en place pour installer sous Debian Wheezy.
+Ce dépôt est signé, pour ajouter la clé du dépôt à votre gestionnaire de paquet, lancez la commande ::
+
+    wget -O - http://deb.iggdrasil.net/contact@iggdrasil.net.gpg.key | apt-key add -
+
+Puis, au choix, ajoutez le dépôt à votre /etc/apt/sources.list ::
+
+    deb http://deb.iggdrasil.net/ wheezy main
+    deb-src http://deb.iggdrasil.net/ wheezy main
+
+Ou sauvegardez le fichier `iggdrasil.list`_ dans votre répertoire **/etc/apt/sources.list.d/** ::
+
+    wget -O - http://deb.iggdrasil.net/dists/wheezy/iggdrasil.list > /etc/apt/sources.list.d/iggdrasil.list
+
+.. _iggdrasil.list: http://deb.iggdrasil.net/dists/wheezy/iggdrasil.list
+
+Ensuite mettez à jour la base de données de votre gestionnaire de paquet et installez le paquet ::
+
+    apt-get update
+    apt-get install python-django-ishtar
+
+Enfin pour créer une nouvelle instance d'Ishtar ::
+
+    INSTANCE=my_ishtar URL=ishtar.my-organization.net ishtar-prepare-instance
+
+INSTANCE est le nom de l'instance et URL le nom du domaine associé. D'autres variables sont disponibles :
+
+- **UWSGI_PORT** : par défaut à 8891, faites bien attention d'incrémenter ce nombre pour chaque nouvelle instance.
+- **NGINX_PORT** : si vous voulez que le serveur web réponde sur un port différent, par exemple si vous avez déjà Apache installé. Ensuite pour accéder à l'application il faudra mettre clairement le numéro de port dans l'adresse du logiciel. Exemple : http://ishtar.my-organization.net:8000
+- **DB_HOST**, **DB_PORT**, **DB_PASSWORD**, **DB_NAME** : si vous souhaitez personnaliser la base de données dans laquelle sera stockée Ishtar. Par défaut, elle sera stockée localement, sur le port par défaut de PostgreSQL (5432), le mot de passe sera généré aléatoirement, le nom de la base de données sera : « ishtar-le_nom_de_mon_instance ».
+
+.. note:: Pour le nom de l'instance, seuls sont permis le tiret bas **_** et les caractères alphanumériques en minuscule. Ce nom doit commencer par un caractères alphabétique.
+..
+  .. warning:: L'installateur présume que vous avez un nom de domaine dédié pour votre installation. Si cela n'est pas le cas, reportez vous à la section de la documentation concernée.
+
+.. warning::
+    En terme de serveur Web, cette première version de l'installateur fonctionne avec la configuration que nous considérons comme la plus optimisée qui est le couple nginx / uwsgi. À terme, l'installateur prendra aussi en compte Apache. Pour l'instant, si vous avez des services tournant sous Apache, plusieurs options se présentent à vous :
+ 
+    - faire tourner nginx sur un autre port (cf. la variable NGINX_PORT) ;
+    - faire fonctionner vos autres services avec nginx (je vous laisse découvrir l'abondante documentation en ligne en cherchant « nginx + le nom de mon service ») ;
+    - configurer Ishtar pour fonctionner avec Apache (référez vous à la `documentation de Django`_).
+
+.. _`documentation de Django`: https://docs.djangoproject.com/fr/1.9/howto/deployment/wsgi/modwsgi/