DokuWiki Installations

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

Installing DokuWiki is very easy - in general it's just a matter of unpacking and setting permissions. You should first try to follow the simple instructions given here, if you encounter problems or the instructions are not detailed enough for you, follow one of the links below.

• 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 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 encounter problems following the steps above or need some detailed information for one of the steps check out these pages:

• Extracting a .tgz archive
• How to set up permissions
• Installing DokuWiki on Hosted Webspace
• install.php instructions
• Upgrading from a previous Version
• Frequently Asked Questions

• Debian
• Gentoo
• FreeBSD
• MacOSX or mac_alt
• OpenSolaris
• Solaris
• Arch Linux
• openSUSE
• Ubuntu
• Fedora
• Windows?
• Synology Diskstation NAS?
• QNAP NAS?

• Lighttpd
• Nanoweb
• IIS
• nginx

• Installing DokuWiki on Hosted Webspace
• DokuWiki on Dreamhost
• DokuWiki on GoDaddy
• DokuWiki on free.fr
• DokuWiki on SourceForge
• DokuWiki on Strato and 1&1

• 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
• Using Git to handle the installation

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

• Check the security page again
• Consider enabling URL rewriting
• Choose a license for your content – use config license or edit the footer.html inside the dokuwiki/lib/tpl/… folder if your template doesn't use tpl_licence() introduced with DokuWiki 2009-02-14.
• Enter a few words how and where you use DokuWiki in the userpage
• Subscribe to the newsletter
• Read:
  • Frequently Asked Questions
  • day-to-day maintenance needed for DokuWiki
  • tips and tricks, especially best-practices to follow after installing

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
• be sure to search the forum before posting your questions to the installation forum