====== 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.

Have a look at the [[:install:screencast|Screencast]] for this type of installation.

===== Installation =====

You should first follow the basic [[..:install|instructions]], e.g.:

  * [[unpacking|Extract]] the tarball somewhere on your harddisk
  * upload all the files within the ''dokuwiki-YYYY-MM-DD'' directory to your webspace  
  * open ''%%http://www.yourserver.com/path/to/dokuwiki/install.php%%''
  * you probably will get some permission errors, [[permissions|fix them]]

===== Troubleshooting =====

If you fixed any permission problems through chmod, it is most probably 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.

For fixing files with already wrong permissions you can either ask your hosting support for help or use the [[tips:fixperms.php]] script.\\ For changing a whole directory with subfolders, FileZilla supports 'recursive setting' of permissions for directories as well as files, or only directories or only files.


===== 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 this [[plugin:SwiftMail]] plugin to configure DokuWiki with an external SMTP server then.

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

  * A list of host-specific information is available at the main [[:install|DokuWiki installation]] page