Differences

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

--- install:debian [2020-11-22 00:55] – [Post Installation] cuppajoeman
+++ 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 ======
-FIXME This page needs an update.
+A Debian package for DokuWiki exists in the official Debian repository and can be installed through the usual Debian tools (i.e. ''apt'').
-DokuWiki is available in the official Debian repository, excluding Stretch, and is able to be installed through the usual Debian tools.
+However, we generally **do not** recommend installing DokuWiki as a Debian package for several reasons:
-  * [[http://packages.debian.org/dokuwiki|Dokuwiki-package overview]]
+  * The package is outdated, using an older release of DokuWiki making it incompatible with many newer plugins
-  * [[http://packages.qa.debian.org/dokuwiki|technical overview and news]]
+  * The package uses a different directory structure, which can make problems with some plugins and may render some general documentation non applicable
-  * [[http://bugs.debian.org/dokuwiki|bug reports]]
+  * The package replaces some of DokuWiki's internal libraries with Debian packages versions which again can lead to incompatibilities
-unfortunately, the instructions on this page no longer for ubuntu, because ubuntu has switched from php5 to php7 .
-===== Installation =====
-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]].
-==== Post Installation ====
+===== DokuWiki Debian Package =====
-== Custom domain ==
-  * If you have your own custom domain, after making it point to the server that you are running the dokuwiki instance on, if you try accessing it you will get a permission denied error, so you will have to edit the file `/etc/dokuwiki/apache.conf` to allow any remote host: so change `Allow from localhost ... ` to `Allow from all`, then restart apache: ''sudo service apache2 restart''
-==== Further Configuration of DokuWiki via the Configuration Manager ====
+You can find details on the official package at these sources:
-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]].
+  * [[http://packages.debian.org/dokuwiki|Dokuwiki-package overview]]
+  * [[http://packages.qa.debian.org/dokuwiki|technical overview and news]]
+  * [[http://bugs.debian.org/dokuwiki|bug reports]]
-==== lighttpd ====
-  apt-get update
+Additional details can be found at the [[https://wiki.debian.org/DokuWiki|DokuWiki page on the Debian Wiki]].
-  apt-get install lighttpd
-  apt-get install php5-cgi php5 dokuwiki
-  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 ====
+===== Recommended Setup =====
-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>
+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.
-==== Apache ====
+This can be as easy as the following for a simple Apache mod_php 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.
+  - Prepare the system, download and unpack the latest DokuWiki version:<code bash>
+$> sudo apt update
-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:
+$> sudo apt install php libapache2-mod-php php-xml php-json php-mbstring php-zip php-intl php-gd
-<code bash>sudo nano /etc/apache2/mods-enabled/dir.conf</code>
+$> sudo systemctl restart apache2.service
-//Note: nano is simply a text editing tool, use whatever you're comfortable with//
+$> wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
+$> tar xzvf dokuwiki-stable.tgz
-Add index.php to the beginning of index files. The page should now look like this:
+$> sudo mv dokuwiki-*a /var/www/html/dokuwiki
-<code>
+$> sudo chown -R www-data:www-data /var/www/html/dokuwiki
-<IfModule mod_dir.c>
-          DirectoryIndex index.php index.html index.cgi index.pl index.php index.xhtml index.htm
-</IfModule>
 </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.