Differences

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

--- install:debian [2017-11-26 20:09] – [lighttpd] 177.191.195.31
+++ install:debian [2024-02-07 19:37] (current) – [DokuWiki on Debian, Ubuntu and derivative Distributions] 2a02:3100:7425:1e00:2530:6ce7:845e:196a
@@ Line 1: / Line 1: @@
-====== DokuWiki package for Debian ======
+====== DokuWiki on Debian, Ubuntu and derivative Distributions ======
-DokuWiki is available in the official Debian repository, excluding Stretch, and is able to be installed through the usual Debian tools.
-  * [[http://packages.debian.org/dokuwiki|Dokuwiki-package overview]]
+A Debian package for DokuWiki exists in the official Debian repository and can be installed through the usual Debian tools (i.e. ''apt'').
-  * [[http://packages.qa.debian.org/dokuwiki|technical overview and news]]
-  * [[http://bugs.debian.org/dokuwiki|bug reports]]
-===== Installation =====
+However, we generally **do not** recommend installing DokuWiki as a Debian package for several reasons:
-All one has to know is written [[https://wiki.debian.org/DokuWiki|here]]. For more information on installing and configuring Dokuwiki on Debian, see [[debian_ubuntu_extras]].
+  * The package is outdated, using an older release of DokuWiki making it incompatible with many newer plugins
+  * The package uses a different directory structure, which can make problems with some plugins and may render some general documentation non applicable
+  * The package replaces some of DokuWiki's internal libraries with Debian packages versions which again can lead to incompatibilities
-==== Further Configuration of DokuWiki via the Configuration Manager ====
-See ->[[:config]], the most nearby options being [[config:userewrite|use rewrite]] and [[config:useslash|use slash]].
-The Extension Managers directory isn't writable. If you want to use this function, set the permissions [[plugin:extension#file_permissions|accordingly]].
+===== DokuWiki Debian Package =====
-==== lighttpd ====
+You can find details on the official package at these sources:
-  apt-get update
+  * [[http://packages.debian.org/dokuwiki|Dokuwiki-package overview]]
-  apt-get install lighttpd
+  * [[http://packages.qa.debian.org/dokuwiki|technical overview and news]]
-  apt-get install php5-cgi php5 dokuwiki
+  * [[http://bugs.debian.org/dokuwiki|bug reports]]
-  lighty-enable-mod fastcgi fastcgi-php dokuwiki
-  /etc/init.d/lighttpd force-reload
-If the DokuWiki mod fails to load, you may need to create a link tooo lighttpd.conf. See [[install:lighttpd]]
-==== nginx ====
+Additional details can be found at the [[https://wiki.debian.org/DokuWiki|DokuWiki page on the Debian Wiki]].
-Insert in ''/etc/nginx/sites-enabled/default''
-<code>
-    # serve static files from nginx
-    location ~ ^/dokuwiki/lib/.+\.(css|gif|js|png)$ {
-        root /usr/share;
-        expires 30d;
-    }
-    location = /dokuwiki/install.php {
-        deny all;
-    }
-    location = /dokuwiki {
-        rewrite ^ /dokuwiki/ permanent;
-    }
-    location = /dokuwiki/ {
-        rewrite ^ /dokuwiki/doku.php last;
-        expires 30d;
-    }
-    location ~ ^/dokuwiki/(|lib/(exe|plugins/[^/]+)/)[^/]+\.php {
-        root /usr/share;
-        fastcgi_pass unix:/var/run/php5-fpm.sock;
-        include        fastcgi_params;
-        # from Debian Jessie, replace the previous include by
-        include snippets/fastcgi-php.conf;
-    }
-    location /dokuwiki/ {
-        deny all;
-    }
-</code>
-==== Apache ====
+===== Recommended Setup =====
-<code bash>sudo apt-get install php5 libapache2-mod-php5 php5-mcrypt dokuwiki
-</code>
-After you answer yes to the prompt twice, PHP will install itself.
+Instead of relying on the Debian package, it is recommended to simply install the webserver and PHP through the package manager and install DokuWiki from the sources.
-If you're just seeing an 'It works!' page or similar, ensure that the default index.html has been removed from the site directory. If you are still having trouble it may also be useful to move ''index.php'' to the beginning of the directory index, This will make sure the ''index.php'' file is served first:
+This can be as easy as the following for a simple Apache mod_php setup:
-<code bash>sudo nano /etc/apache2/mods-enabled/dir.conf</code>
-//Note: nano is simply a text editing tool, use whatever you're comfortable with//
-Add index.php to the beginning of index files. The page should now look like this:
+  - Prepare the system, download and unpack the latest DokuWiki version:<code bash>
-<code>
+$> sudo apt update
-<IfModule mod_dir.c>
+$> sudo apt install php libapache2-mod-php php-xml php-json php-mbstring php-zip php-intl php-gd
-          DirectoryIndex index.php index.html index.cgi index.pl index.php index.xhtml index.htm
+$> sudo systemctl restart apache2.service
-</IfModule>
+$> wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
+$> tar xzvf dokuwiki-stable.tgz
+$> sudo mv dokuwiki-*a /var/www/html/dokuwiki
+$> sudo chown -R www-data:www-data /var/www/html/dokuwiki
 </code>
-All one has to do is already done through the Dokuwiki package and it's built in postinstallation routines.
+  - **Optional**\\ If you use a firewall, allow HTTP traffic. For the Uncomplicated Firewall (ufw) the command would be this:<code bash>
-''/etc/dokuwiki/apache.conf'' got linked:
+sudo ufw allow 'Full'
-<code bash>
-ls -l /etc/apache2/conf-available/
-lrwxrwxrwx 1 root root   25 Apr  5  2014 dokuwiki.conf -> /etc/dokuwiki/apache.conf
-ls -l /etc/apache2/conf-enabled/
-lrwxrwxrwx 1 root root   32 Apr  5  2014 dokuwiki.conf -> ../conf-available/dokuwiki.conf
 </code>
+  - Point your web browser to %%http://localhost/dokuwiki/install.php%% to configure your new DokuWiki installation.
-Within the Apache config file (''dokuwiki.conf'' or ''apache.conf''), change ''Alias'' and ''Allow from localhost 127.0.0.1 ::1'' to your needs; the default allows only viewing from the host running dokuwiki, and ''Allow from all'' will allow viewing from any remote host.