-------------------------------------------
  * **dokuwiki** 
  * **Jonathan Haack**
  * **Haack's Networking**
  * **webmaster@haacksnetworking.org** 

-------------------------------------------
To install dokuwiki:

  wget https://download.dokuwiki.org/out/dokuwiki-9beb5257bbbc840e687c3b130541d3d2.tgz
  tar zxvf doku.tgz
  
Once that's done, follow the instructions in  [[https://wiki.haacksnetworking.org|Apache Survival]] in order to set up a dedicated domain and virtual host for your wiki. Once that's done, replace the ''public_html'' directory with the dokuwiki directory above. Once that's done, establish correct permissions:

  sudo chmod g+rwx /var/www/jonathanhaack.com/public_html/dokuwiki
  sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/conf
  sudo chown -R www-data:user /var/www/jonathanhaack.com/public_html/dokuwiki/conf
  sudo chown www-data:user /var/www/jonathanhaack.com/public_html/dokuwiki/data
  sudo chmod -R 775 /var/www/jonathanhaack.com/public_html/dokuwiki/data
  sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/lib
  sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/conf
  cd /var/www/jonathanhaack.com/public_html/dokuwiki/data/
  sudo chmod 2775 {attic,cache,index,locks,media,meta,pages,tmp,media_attic,media_meta}
  sudo chown www-data:user {attic,cache,index,locks,media,meta,pages,tmp,media_attic,media_meta}

After permissions are all set, navigate to the installer page so it can instantiate the database and global wiki settings.

  https://wiki.jonathanhaack.com/install.php

Eventually your instance will become outdated and you will need to [[https://www.dokuwiki.org/install:upgrade|upgrade]]. In that case, first back up the install, then wget the new tgz file, then unpack and migrate the new content on top of the existing as follows:  
  
  zip -r doku-bu-date.zip /path/to/doku
  wget https://getdownloadlinkfromsite.tgz
  tar zxvf dokuwiki-example-39fe13964.tgz
  'cp' -af dokuwiki/* /var/www/jonathanhaack.com/public_html/dokuwiki/
  
Remember, the permissions will be wrong on the files you copied over since root performed that task. In order to make the instance functional again, you need to re-update the permissions (same as above):

  sudo chmod g+rwx /var/www/jonathanhaack.com/public_html/dokuwiki
  sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/conf
  sudo chown -R www-data:user /var/www/jonathanhaack.com/public_html/dokuwiki/conf
  sudo chown www-data:user /var/www/jonathanhaack.com/public_html/dokuwiki/data
  sudo chmod -R 775 /var/www/jonathanhaack.com/public_html/dokuwiki/data
  sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/lib
  sudo chmod -R 755 /var/www/jonathanhaack.com/public_html/dokuwiki/conf
  cd /var/www/jonathanhaack.com/public_html/dokuwiki/data/
  sudo chmod 2775 {attic,cache,index,locks,media,meta,pages,tmp,media_attic,media_meta}
  sudo chown www-data:user {attic,cache,index,locks,media,meta,pages,tmp,media_attic,media_meta}

Dokuwiki details their rational for these permission recommendations here:  [[https://www.dokuwiki.org/install:permissions|Install Permissions]]. The recommended permissions from them - which I used to make my own permissions above - are listed below for historical reference:

  yourwiki> chmod -R 775 data/
  yourwiki> chown -R www-data:foo data/
  everything below the data directory:
  yourwiki/data> chmod 2775 {attic,cache,index,locks,media,meta,pages,tmp}
  yourwiki/data> chown www-data:foo {attic,cache,index,locks,media,meta,pages,tmp}

 --- //[[alerts@haacksnetworking.org|oemb1905]] 2026/01/01 23:21//