Differences

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

--- install:debian [2016-02-29 23:54] – ach
+++ 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 and is installable 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 to 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
-</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.
-It may also be useful to add php to the directory index, to serve the relevant php index files:
+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>
-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
+$> sudo systemctl restart apache2.service
-          DirectoryIndex index.php index.html index.cgi index.pl index.php index.xhtml index.htm
+$> wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
+$> tar xzvf dokuwiki-stable.tgz
-</IfModule>
+$> 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.
-  * 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.