Differences

This shows you the differences between two versions of the page.

--- installer [2016-05-06 00:41] – removed 145.253.236.155
+++ installer [2024-04-14 17:10] (current) – [DokuWiki Installer] 81.61.118.168
@@ Line 1: / Line 1: @@
+====== DokuWiki Installer ======
+The setup script ''install.php'' assists you to do your initial [[DokuWiki]] setup. It checks for the availability of required PHP functions and checks for needed file permissions.
+It also creates an initial administrator account and an initial [[ACL]] policy.
+To run the installer, open the page ''%%http://<DokuWiki-Path>/%%**install.php**'' in the web browser. (For security reasons it will only work with a new and unmodified DokuWiki installation.)
+Read further for description of the fields and an explanation of errors for troubleshooting.
+===== The fields to fill in =====
+These are the options you may set in the installer and their meaning.
+  * **Wiki Name**\\ This configures the [[config:title]] option of the Wiki. It's what will be displayed in the upper right corner of the default template.
+  * **Enable ACL**\\ Only if this field is checked, the other fields are available. DokuWiki won't need the [[ACL]] setup, but it is recommended because without it the administrative interface won't be accessible.
+  * **Superuser**\\ This is the username of the to be created administrator account. It should be lowercase and ASCII letters only. No spaces are allowed here.
+  * **Full Name**\\ The real name of the superuser.
+  * **E-Mail**\\ The email address of the superuser. No advanced checking is done here only an @ character is required, but you should supply a valid address none the less.
+  * **Password**\\ The password for the superuser.
+  * **Once Again**\\ Repeat the password. This is to avoid typing errors.
+  * **Initial ACL policy**!\\ The installer will set up an initial [[ACL]] configuration for you. What you choose here depends on how you intend to use the Wiki. This is only an initial setup, you probably want to adjust the ACL rules later
+  * **Allow users to register themselves** \\ If kept unchecked, users cannot register themselves (i.e. [[config:disableactions]] contains the "register" command).
+===== Possible error message =====
+The installer will check certain requirements to make sure the server you want to install DokuWiki to is able to run it. The following messages may be shown by the installer.
+**xxx is not writable by DokuWiki. You need to fix the permission settings of this directory!**\\
+This is probably the most common error. You need to make the indicated directory writable by the webserver. Refer to [[.:install:permissions]] for more info.
+Another probable cause is if you tried to move the data and conf directories (Read description on [[security|Security]] before executing the installer. The move operation must be realized only __after__ the end of the installation process.)
+__SELinux issue__
+If it still doesn't work, then probably it's a selinux issue which is not allowing the webserver process to write to these directories. You can confirm this issue by disabling selinux and try executing your php web service again (''sudo setenforce 0'').
+If the above step solves your issue, then re-enable selinux (''sudo setenforce 1''), and run following commands from terminal:
+<code>
+# grep httpd /var/log/audit/audit.log | audit2allow -M mypol
+# semodule -i mypol.pp
+</code>
+**PHP function xxx is not available. Maybe your hosting provider disabled it for some reason?**\\
+This means a certain function usually provided by the PHP interpreter was not found. This can mean your PHP version is too old (DokuWiki needs PHP 7.2 at least, PHP 8 preferred - see also the [[:Requirements|system requirements]]), you are missing a certain PHP extension (unlikely) or your provider disabled the  function for some reason.
+You need to fix this problem somehow or DokuWiki won't work. So either upgrade your PHP version or ask your provider to check the PHP settings.
+**xxx - illegal or empty value**\\
+You entered a value which is not allowed for that field. See field descriptions for what each field expects.