notes/projects/TU_Homepage/DokuWiki_Install.md

Ressources

• Install
• security
• php
• non-official install
• installer.php
• download page
• used tarball

History

Install web server (ngnix), php and its desired modules:

apt install nginx php php-fpm php-xml php-mbstring php-zip php-intl php-gd php-json php-bz2

Download the tarball , unpack the distribution tarball and upload/copy the files to your webspace:

wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
tar xzvf dokuwiki-stable.tgz
mv dokuwiki-*a /var/www/dokuwiki
chown -R www-data:www-data /var/www/dokuwiki

Create the nginx config file at /etc/nginx/sites-available/example.com with the following input. Nginx config example(change accordingly to your needs. mainly change "server_name"):

server {
    listen 80;
    listen [::]:80;
    server_name example.com 10.0.0.10;

    # Maximum file upload size is 4MB - change accordingly if needed
    client_max_body_size 4M;
    client_body_buffer_size 128k;

    root /var/www/dokuwiki;
    index doku.php;

    #Remember to comment the below out when you're installing, and uncomment it when done.
    location ~ /(conf/|bin/|inc/|vendor/|install.php) { deny all; }


    # .ht             - .htaccess, .htpasswd, .htdigest, .htanything
    # .git, .hg, .svn - Git, Mercurial, Subversion.
    # .vs             - Visual Studio (Code)
    # All directories except lib.
    # All "other" files that you dont want to delete, but dont want public.
    location ~ /(\.ht|\.git|\.hg|\.svn|\.vs|data|conf|bin|inc|vendor|README|VERSION|SECURITY.md|COPYING|composer.json|composer.lock) {
        # Returns 403
        deny all;
        #return 404;
    }


    #Support for X-Accel-Redirect
    location ~ ^/data/ { internal ; }

    location ~ ^/lib.*\.(js|css|gif|png|ico|jpg|jpeg)$ {
        expires 365d;
    }

    location / { try_files $uri $uri/ @dokuwiki; }

    location @dokuwiki {
        # rewrites "doku.php/" out of the URLs if you set the userwrite setting to .htaccess in dokuwiki config page
        rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
        rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
        rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
        rewrite ^/(.*) /doku.php?id=$1&$args last;
    }

    location ~ \.php$ {
        try_files $uri $uri/ /doku.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param REDIRECT_STATUS 200;
        fastcgi_pass unix:/var/run/php/php-fpm.sock;
        # fastcgi_pass unix:/var/run/php5-fpm.sock; #old php version
    }
}

Enable the Website:

ln -s /etc/nginx/sites-available/dokuwiki /etc/nginx/sites-enabled/

Restart nginx and php in order for the changes to take effect:

systemctl restart nginx && systemctl restart php8.2-fpm

To run the installer, open the page http://DokuWiki-IP/install.php in the web browser. Follow installer.php manual.

Once that’s done, remember to uncomment the location line on the nginx configuration file. Open /etc/nginx/sites-available/dokuwiki with a text editor and remove the “#” symbol at the beginning of the line.

Reload nginx once again so that the changes take effect.

systemctl restart nginx