Table of Contents
DokuWiki on a hosted server
If you want to install DokuWiki on rented webspace this document has some useful tips. You might also want to look into using the DokuWiki Downloader instead of manually installing.
You can also use one of our hosting partners which provide a preinstalled DokuWiki for you.
Many other hosters also provide one click installations via Softaculous or similar tools.
Have a look at the Screencast for this type of installation.
Installation
You should first read through the general instructions, particularly the system requirement and security notes. Then follow these basic install steps:
- Extract the tarball somewhere on your hard disk.
- Upload all the files within the
dokuwiki-YYYY-MM-DD
directory to your webspace. - Open
http://www.yourserver.com/path/to/dokuwiki/install.php
to use the graphical configuration tool.
Uploading
Most web hosters provide SFTP or FTP access to their web space. To use this, you need an FTP client program. Filezilla is a good, Free and Open-Source FTP-Client available for many platforms.
Many hosters also provide upload facilities via a Web Administration panel.
Ususally, your web hoster will have detailed documentation on how to upload files. If in doubt contact your web hoster's support, they will point you in the right direction.
Troubleshooting
Permissions
The most common issue you may encounter is permission problems. Usually caused because the webserver runs as different user than the account you use to upload your files. If the group differs as well then the webserver (which runs the DokuWiki application) will create files you will not be able to delete as your normal (FTP) user. To avoid this you need to relax permissions setting through the fmode and dmode settings.
Please refer to Setting up file permissions for more info on how to address permission errors.
PHP Version
Many hosters allow you to select a PHP version to use via their administration panel. On first setup, you will probably have a good version pre-selected. However over the years, this pre-selection may become outdated. Always check the PHP requirements before updating DokuWiki and adjust the setting in your hoster's admin panel as needed.
E-mail not working
Some hosting providers do not provide a working sendmail on their servers. Instead, a separate machine runs SMTP and requires authentication. In this scenario, DokuWiki's email features, including allowing new users to register and receive a password, will not work.
It is recommended to use the SMTP Plugin to configure DokuWiki with an external SMTP server then.