====== 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 [[downloader|DokuWiki Downloader]] instead of manually installing.

You can also use one of our [[:hosting|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 [[:install:screencast|Screencast]] for this type of installation.

===== Installation =====

You should first [[..:install|read through the general instructions]], particularly the system requirement and security notes. Then follow these basic install steps:

  * [[unpacking|Extract]] the tarball somewhere on your hard disk.
  * Upload all the files within the ''dokuwiki-YYYY-MM-DD'' directory to your webspace.    
  * [[permissions|Give proper permissions to certain folders and files]].
  * 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. [[https://filezilla-project.org/|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 [[..:config:fmode]] and [[..:config:dmode]] settings.

Please refer to [[permissions|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 [[plugin:smtp|SMTP Plugin]] to configure DokuWiki with an external SMTP server then.

===== See also =====

  * [[:install#Web Host Specifics]]