Table des matières
Installation de DokuWiki
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.
- Vérifiez que votre serveur répond aux exigences de configuration requise.
- Téléchargez la dernière version depuis la page de téléchargement (en anglais).
- 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
- Décompactez l'archive et téléverser / 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 installer.) - 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.
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 :
Distributions/Systèmes d'exploitation
- Alpine Linux (en anglais)
- Arch Linux (en anglais)
- Fedora (en anglais)
- OpenBSD (en anglais)
- OpenSolaris (en anglais)
- openSUSE (en anglais)
- QNAP NAS (en anglais)
- Solaris (en anglais)
- Ubuntu (en anglais)
Serveurs web
Hébergeurs
Certains hébergeurs ont DokuWiki inclus dans leur liste de paquets installables rendant l'installation presque automatique.
- DokuWiki sur Strato et 1&1 (en anglais)
- Amazon EC2 (en anglais)
- CiviHosting (en anglais)
- Dreamhost (en anglais)
- GoDaddy (en anglais)
- Hosted Webspace (en anglais)
- Microsoft Azure Web App Service (en anglais)
- ovh.com (en anglais)
Installations alternatives
- Cloudron est une solution complète pour faire fonctionner des applications sur votre serveur et les conserver à jour et sécurisées. Il existe a une App DokuWiki pour Cloudron. Ils surveillent activement les versions de DokuWiki (source) et diffusent des mises à jour automatiques. Demo (username: cloudron password: cloudron)
- DokuWiki Downloader – Un unique script PHP qui prend soin de télécharger et d'installer DokuWiki.
- TurnKey DokuWiki Appliance – Un serveur virtuel libre et à code ouvert basé sur Ubuntu léger et facile à utiliser. Mis à jour automatiquement chaque jour avec les derniers correctifs de sécurité. Se déploie en quelques minutes sur une machine virtuel, une machine nue, ou dans le cloud. Fait partie de la TurnKey Linux Virtual Appliance Library.
- DokuWiki on a Stick – installer DokuWiki directement depuis une clé USB ! (en anglais)
- DokuWiki Bitnami Stack – un installeur qui déploie DokuWiki et tout ce qui est nécessaire pour le faire fonctionner (Apache, PHP-. Disponible pour Linux, Windows, Mac x86, Mac PPC, Solaris x86 et solaris SPARC.
- DokuWiki Bitnami Module – un installeur qui déploie DokuWiki sur une pile LAMP si vous utilisez Linux, ou une pile MAMP, WAMP, SAMP si vous utilisez un mac, Windows solaris Solaris et qui permet de partager un serveur web, des bases de données1) ainsi que des bibliothèques d'exécution avec d'autres modules d'application.
- Desktop Wiki – un autre DokuWiki portable, qui semble non maintenu. Dernière mise à jour en 2013.
- Portable DokuWiki using Uniform Server PHP MicroServer DokuWiki portable qui utilise le microserver PHP Uniform.
- Synology NAS Le système d'exploitation «Disk Station Manager» fournit un paquet DokuWiki pour une installation facile.
- Pour une installation purement locale sur un mac, installer en utilisant php build-in webserver.
Problème avec l'extension PHP suhosin
(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.
Ça marche ! Et maintenant ?
Voici ce que vous devriez faire quand tout fonctionne bien :
- Relisez la page sur la sécurité une nouvelle fois
- Activez l'URL rewriting
- 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 :
- Maintenance nécessaire (en anglais)
- Trucs et astuces, et plus particulièrement les 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 :
- 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 la section française et la section Installation (en anglais)
Version en cours de développement
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 :
- copiez le hash qui vous sera donné, par exemple
'1e5c42eac3219d9e21927c39e3240aad
' - ouvrez le fichier
install.php
et cherchez$dokuwiki_hash array
- dupliquez la dernière ligne de l'array, par exemple
'2007-06-26' => 'b3ca19c7a654823144119980be73cd77',
- modifiez votre ligne en double pour changer la date et le hash, par exemple
'2008-03-17' => '1e5c42eac3219d9e21927c39e3240aad',
- sauvegardez, envoyez sur le serveur et relancez
install.php
Crédits
- Philippe LAPEYRIE 21/05/2006 21:08
- Laynee 23/10/2008 00:21
- — Digitalin 2018-01-26 19:40