Si vous souhaitez simplement mettre à jour votre installation, veuillez consulter les instructions de mise à jour.

L'installation de 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.

1. Vérifiez que votre serveur répond aux exigences de configuration requise.
2. Téléchargez la dernière version depuis la page de téléchargement (en anglais).
3. Lisez bien la 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 mailing list
4. Décompactez l'archive et téléverser / copiez les fichiers sur votre espace web.
5. Lancez la page install.php depuis votre navigateur et suivez les instructions. (Pour plus d'information, consultez la page installer.)
6. Amusez-vous avec votre installation de votre DokuWiki tout en parcourant son manuel pour découvrir toutes ses fonctionnalités

Une capture vidéo de l'installation d'un DokuWiki vous montre comment installer DokuWiki chez un hébergeur.

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 :

• Décompacter une archive .tgz
• Paramétrer les permissions
• Installer DokuWiki sur un hébergeur
• install.php instructions
• Mise à jour depuis une version précédente
• Questions fréquentes

• Arch Linux (en anglais)
• CentOS
• Debian
• Fedora (en anglais)
• FreeBSD
• Gentoo
• MacOSX ou mac_alt (en anglais)
• OpenBSD
• OpenSolaris (en anglais)
• openSUSE (en anglais)
• QNAP NAS (en anglais)
• Solaris (en anglais)
• Ubuntu (en anglais)
• Windows (en anglais)

• Apache sous Windows
• darklight (en anglais)
• Hiawatha (en anglais)
• IIS (en anglais)
• Lighttpd (en anglais)
• Mongoose (en anglais)
• Nanoweb (en anglais)
• nginx (en anglais)
• OpenLiteSpeed (en anglais)

Certains hébergeurs ont DokuWiki inclus dans leur liste de paquets installables rendant l'installation presque automatique.

• Installer DokuWiki sur un hébergeur
• DokuWiki sur Sourceforge
• DokuWiki sur Free.fr
• DokuWiki sur Strato et 1&1 (en anglais)
• Amazon EC2 (en anglais)
• Dreamhost (en anglais)
• GoDaddy (en anglais)
• Hosted Webspace (en anglais)
• Microsoft Azure Web App Service (en anglais)
• ovh.com (en anglais)

• Cloudron.io has a DokuWiki App that can be installed on your Cloudron Smartserver. They actively track DokuWiki releases (source) keeping your installation up-to-date.
• DokuWiki Downloader – a single script that takes care of downloading and installing DokuWiki
• TurnKey DokuWiki Appliance – a free open source virtual appliance based on Ubuntu that's easy to use and lightweight. Auto-updated daily with latest security patches. Deploys in minutes to a Virtual Machine, bare metal, or in the cloud. Part of the TurnKey Linux Virtual Appliance Library.
• DokuWiki on a Stick – installer DokuWiki directement depuis une clé USB ! (en anglais)
• DokuWiki Bitnami Stack – an installer which deploys DokuWiki and all that's necessary to run it (Apache, PHP). Available for Windows, Linux, Mac x86, Mac PPC, Solaris x86 and Solaris SPARC.
• DokuWiki Bitnami Module – an installer which deploys DokuWiki on top of LAMPStack if you are using Linux, or MAMPStack, WAMPStack or SAMPstack if you are using Mac, Windows or Solaris allowing to share database, webserver and language runtime with other applications modules.
• Desktop Wiki – another portable DokuWiki, but it is seemingly unmaintained (not updated since 2013)
• Using Git to handle the installation
• Portable DokuWiki using Uniform Server PHP MicroServer
• Synology NAS operating system “Disk Station Manager” provides DokuWiki package for easy installing
• For local desktop wiki (on Mac) install using php build-in webserver.

(Applicable depuis la version 2015-08-10 “Detritus”)

Si votre installation PHP possède l'extension PHP suhosin, vous devez modifier les 2 paramètres suhosin.post.disallow_nul et suhosin.request.disallow_nul dans php.ini à 0, sinon ni l'édition de pages ni les greffons ne fonctionnerons pas.
Lorsque vous enregistrez votre page, vous revenez en mode edition.
Pour les greffons, les boutons 'installer' et 'mettre à jour' ne fonctionne pas.

Vous pouvez vérifier votre configuration du serveur PHP en y déposant un fichier test.php avec le code suivant :

<?php phpinfo(); ?>

puis y accéder à l'aide de votre navigateur.

Si votre fournisseur d'hébergement ne vous donne pas accès à vos fichiers de configuration, veuillez leur demander de faire la modification.

Voici ce que vous devriez faire quand tout fonctionne bien :

• Relisez la page sur la sécurité une nouvelle fois
• Activez l'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 DokuWiki dans la page des utilisateurs de DokuWiki
• Abonnez-vous à DokuWiki sur 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 :
  • Foire Aux Questions
  • Maintenance nécessaire (en anglais)
  • Trucs et astuces, et plus particulièrement les bonnes pratiques (en anglais) à suivre après l'installation

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

• télécharger à nouveau l'archive pour être sûr que votre téléchargement n'a pas été corrompu la première fois
• téléverser à nouveau les fichiers – les erreurs FTP sont courantes. Téléverser un fichier zip et le décompacter depuis le serveur est souvent plus fiable que de téléverser tous les fichiers un à un
• revérifiez les permissions des fichiers et des répertoires – c'est une source de problème très fréquente
• faites une recherche sur le forum avant de poster votre question dans le forum Installation

Si vous essayez d'installer une 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 :

1. copiez le hash qui vous sera donné, par exemple '1e5c42eac3219d9e21927c39e3240aad'
2. ouvrez le fichier install.php et cherchez

   $dokuwiki_hash array

3. dupliquez la dernière ligne de l'array, par exemple

   '2007-06-26'   => 'b3ca19c7a654823144119980be73cd77',

4. modifiez votre ligne en double pour changer la date et le hash, par exemple

   '2008-03-17'   => '1e5c42eac3219d9e21927c39e3240aad',

5. sauvegardez, envoyez sur le serveur et relancez install.php

• Philippe LAPEYRIE 21/05/2006 21:08
• Laynee 23/10/2008 00:21
  
• — Digitalin 2018-01-26 19:40