====== Installation de DokuWiki ======

Si vous souhaitez simplement mettre à jour votre installation, veuillez consulter les [[fr:install:upgrade|instructions de mise à jour]].

L'installation de [[fr:DokuWiki]] est très facile -- en général il suffit de décompacter l'archive et de fixer les permissions. Vous devriez d'abord suivre les instructions simplifiées ci-dessous et, si vous rencontrez des problèmes, ou que ces instructions ne sont pas suffisamment détaillées pour vous, vous pouvez vous reporter aux [[#instructions détaillées]] un peu plus bas dans la page.

  - Téléchargez la dernière version depuis la [[sb>dokuwiki|page de téléchargement]] (en anglais).
  - Lisez bien la [[fr:security|page sur la sécurité]] //avant// de commencer l'installation. Ne prenez pas cette étape à la légère -- si vous avez un doute, demandez conseil sur la [[mailinglist|mailing list]]
  - Décompactez l'archive et uploadez / copiez les fichiers sur votre espace web. 
  - Lancez la page ''install.php'' depuis votre navigateur et suivez les instructions. (Pour plus d'information, consultez la page [[fr:installer]].)
  - Amusez-vous avec votre installation de votre Dokuwiki tout en parcourant son [[fr:manual|manuel]] pour découvrir toutes ses fonctionnalités

Une [[fr:install:screencast|capture vidéo de l'installation d'un DokuWiki]] vous montre comment installer DokuWiki sur un hébergeur.


===== Instructions détaillées =====

Si vous rencontrez des problèmes en suivant l'installation simplifiée ci-dessus, ou que vous avez besoin d'informations détaillées sur une étape en particulier, consultez ces pages :

  * [[fr:install:unpacking|Décompacter une archive .tgz]]
  * [[install:permissions|Paramétrer les permissions]] (en anglais)
  * [[fr:install:hosted|Installer DokuWiki sur un hébergeur]]
  * [[fr:installer|install.php]]
  * [[fr:install:upgrade|Mise à jour depuis une version précédente]]
  * Distributions/Systèmes d'exploitation :
    * [[fr:install:Debian]]
    * [[fr:install:Gentoo]]
    * [[fr:install:FreeBSD]]
    * [[fr:install:MacOSX]] ou [[install:mac_alt]] (en anglais)
    * [[install:Solaris]] (en anglais)
  * Serveurs web :
    * [[install:Lighttpd]] (en anglais)
    * [[install:Nanoweb]] (en anglais)
    * [[install:IIS]] (en anglais)
    * [[fr:install:Apache sous Windows]]
  * Hébergeurs :
    * [[fr:install:hosted|Installer DokuWiki sur un hébergeur]]
    * [[fr:install:sourceforge|DokuWiki sur Sourceforge]]
    * [[fr:install:free.fr|DokuWiki sur Free.fr]]
    * [[install:strato|DokuWiki sur Strato et 1&1]]
  * Installations alternatives :
    * [[:dokuwiki_on_a_stick|DokuWiki on a Stick]] -- installer DokuWiki directement depuis une clé USB ! (en anglais)
    * [[http://bitnami.org/stack/dokuwiki|DokuWiki Bitnami Stack]] -- pour installer un pack DokuWiki + Apache + PHP (en anglais)
    * [[devel:darcs#maintaining_a_stable_version_with_darcs|Laisser Darcs se charger de l'installation]]
  * [[FAQ|Foire Aux Questions]]


===== Ça marche ! Et maintenant ? =====

Voici ce que vous devriez faire quand tout fonctionne bien :

  * Relisez la [[fr:security|page sur la sécurité]] une nouvelle fois ;-)
  * Activez l'[[:rewrite|URL rewriting]] (en anglais)
  * Choisissez une licence pour votre contenu -- éditez le fichier ''footer.html'' dans le dossier dokuwiki/lib/tpl/default pour qu'il reflète la bonne licence
  * Écrivez quelques lignes sur votre utilisation de [[fr:DokuWiki]] dans la page des [[fr:users|utilisateurs de DokuWiki]]
  * [[http://freshmeat.net/subscribe/48181/|Abonnez-vous]] à DokuWiki sur [[http://www.freshmeat.net|Freshmeat.net]] pour être tenu au courant des mises à jour et recevoir un mail si jamais un problème de sécurité est rencontré
  * Lisez :
    * [[fr:faq|Foire Aux Questions]]
    * [[tips:maintenance|Maintenance nécessaire]] (en anglais)
    * [[fr:tips|Trucs et astuces]], et plus particulièrement les [[tips:tailorwikirules|bonnes pratiques]] (en anglais) à suivre après l'installation
===== Ça ne marche pas ! Résolution des problèmes =====

Si vous avez rencontré des problèmes pendant l'installation de DokuWiki et que vous avez suivi attentivement chacune des étapes ci-dessus :

  * [[sb>dokuwiki|télécharger à nouveau l'archive]] pour être sûr que votre téléchargement n'a pas été corrompu la première fois
  * uploadez à nouveau les fichiers -- les erreurs FTP sont courantes. Uploader un fichier zip et le décompacter depuis le serveur est souvent plus fiable que d'uploader tous les fichiers un à un
  * revérifiez les [[install:permissions|permissions des fichiers et des répertoires]] -- c'est une source de problème **très** fréquente
  * faites une [[http://forum.dokuwiki.org/search|recherche sur le forum]] avant de poster votre question dans le forum [[http://forum.dokuwiki.org/forum/2/|Installation]]
 
=== Version en cours de développement ===

Si vous essayez d'installer une [[http://dev.splitbrain.org/browse/snapshots/|version en cours de développement]] (qui corrigera certains bugs mais en introduira peut-être de nouveaux) et que vous obtenez le message « unrecognised or modified dokuwiki.php », faites ceci :

  - copiez le hash qui vous sera donné, par exemple '''1e5c42eac3219d9e21927c39e3240aad'''
  - ouvrez le fichier ''install.php'' et cherchez <code>$dokuwiki_hash array</code>
  - dupliquez la dernière ligne de l'array, par exemple <code>'2007-06-26'   => 'b3ca19c7a654823144119980be73cd77',</code>
  - modifiez votre ligne en double pour changer la date et le hash, par exemple <code>'2008-03-17'   => '1e5c42eac3219d9e21927c39e3240aad',</code>
  - sauvegardez, envoyez sur le serveur et relancez ''install.php''



===== Credits =====

  * //[[philippe@bdsemin.com|Philippe LAPEYRIE]] 21/05/2006 21:08//
  * //Laynee 23/10/2008 00:21//