DokuWiki

It's better when it's simple

User Tools

Site Tools


Sidebar

Translations of this page?:

Learn about DokuWiki

Advanced Use

Corporate Use

Our Community


Follow us on Facebook, Twitter and other social networks.

Our Privacy Policy

install

DokuWiki Installation

There are separate upgrade instructions if you have an existing installation.

Try these instructions first. If you still need help, follow one of the links below:

  • Step 0: Make sure your server meets the requirements.
  • Step 1: Download the newest release from the Download Page.
  • Step 2: Read the security page before you begin installing. Take it seriously. If in doubt, ask on the mailing list
  • Step 3: Unpack the distribution tarball and upload/copy the files to your webspace.
  • Step 4: Open the install.php file in your browser and follow the instructions. (For additional information, see the installer page.)
  • Step 5: Enjoy your DokuWiki install and browse through the manual to discover what you can do with it.

A screencast of installing DokuWiki shows installation to a shared web hosting provider, but it may be useful for other situations as well. If you don't have a webhoster yet, check our hosting partners for a pre-installed DokuWiki.

If you are looking to create multiple Wiki's, you can create a DokuWiki farm. This is similar to the idea of multi-sites. Instructions on how to do this manually are provided in the Farm page.

Detailed Instructions

If you encounter problems following the steps above or need some detailed information for one of the steps check out these pages:

Distribution/OS Specifics

Webserver Specifics

Web Host Specifics

Some web hosts have DokuWiki included in their list of installable packages making the install almost automatic.

Alternative Install Methods

  • IBM Cloud is a hybrid cloud platform , on which you can install Dokuwiki with a couple of clicks on a kubernetes cluster with bitnami charts
  • Cloudron is a complete solution for running apps on your server and keeping them up-to-date and secure. There is a DokuWiki App for Cloudron. They actively track DokuWiki releases (source) and push automatic updates. Demo (username: cloudron password: cloudron)
  • 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 – run DokuWiki directly from an USB stick
  • 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)
  • 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.

Pitfall on suhosin PHP extension

If your PHP installation has suhosin php extension installed, remember to set suhosin.post.disallow_nul and suhosin.request.disallow_nul in php.ini to 0, otherwise the Edit page and the Plugin page won't work. (For the Edit page it loops back to the Edit page when you save the page, and for the Plugin page the plugin install/update button will not work.)

You can confirm your server PHP configuration by putting a file named test.php on the server with the following content:

<?php phpinfo(); ?>

and use the web browser to visit the page.

If your dokuwiki is installed on a web hosting that you cannot change server configuration, please ask your web hosting to change the required configuration.

It Works! What Now?

Here is what you may want to do when everything is up and working:

If you've encountered problems installing DokuWiki, and you've carefully checked each of the steps above:

  • Download the source package again to ensure you do not have a corrupt download
  • Upload your files again—FTP corruption is a common cause for problems. Uploading a zip file and extracting on the server may be more reliable than uploading files individually
  • Double and triple check file and folder permissions – this is a very common cause of problems
install.txt · Last modified: 2020-10-26 11:40 by Pokoli