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

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

  wget doku.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. 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}

 --- //[[jonathan@haacksnetworking.org|oemb1905]] 2022/07/14 22:47//