How to Install PukiWiki on POP! OS

PukiWiki is a wiki software that is written in PHP language. It is free and open-source software that can be used for creating and managing wiki pages that are free and collaborative. This tutorial will guide you on how to install PukiWiki on POP! OS.

Prerequisites

Step 1 - Downloading PukkiWiki

  1. Open the terminal application by pressing ctrl+alt+t.
  2. Run the following command to download the latest version of PukiWiki:
$ sudo wget https://ja.osdn.net/frs/redir.php?m=ikiwiki&f=%2Fpukiwiki%2F68083%2Fpukiwiki-1.5.2_utf8.zip -O pukiwiki.zip
  1. Extract the downloaded zip file by running the following command:
$ sudo unzip pukiwiki.zip
  1. Move the PukiWiki directory to the Apache web server directory by running the following command:
$ sudo mv pukiwiki /var/www/html/

Step 2 - Creating a Database for PukiWiki

  1. Log in to the MySQL database by running the following command:
$ sudo mysql -u root -p
  1. Create a new database for PukiWiki by running the following command:
mysql> CREATE DATABASE pukiwiki_db;
  1. Create a new user for the PukiWiki database by running the following command:
mysql> CREATE USER 'pukiwiki_user'@'localhost' IDENTIFIED BY 'password';
  1. Grant privileges to the newly created user by running the following command:
mysql> GRANT ALL PRIVILEGES ON pukiwiki_db . * TO 'pukiwiki_user'@'localhost';
  1. Flush the privileges by running the following command:
mysql> FLUSH PRIVILEGES;
  1. Exit the MySQL database by running the following command:
mysql> exit;

Step 3 - Configuring PukiWiki

  1. Navigate to the PukiWiki directory by running the following command:
$ cd /var/www/html/pukiwiki/
  1. Rename the config file by running the following command:
$ sudo mv pukiwiki.ini.php.sample pukiwiki.ini.php
  1. Open the PukiWiki config file by running the following command:
$ sudo nano pukiwiki.ini.php
  1. Update the following fields in the PukiWiki config file:

    • $edit_auth - set this to true
    • $edit_auth_pages - update this to access the pages of your choice
    • $mysql_auth - set this to true
    • $mysql_server - set this to 'localhost'
    • $mysql_user - set this to the user you created for PukiWiki database
    • $mysql_pass - set this to the password you created for PukiWiki user
    • $mysql_db - set this to the name of the database you created for PukiWiki
  2. Save and close the PukiWiki config file by typing ctrl+x, y, and enter.

Step 4 - Setting Permissions

  1. Change the ownership of the PukiWiki directory to the Apache web server user by running the following command:
$ sudo chown -R www-data:www-data /var/www/html/pukiwiki/
  1. Change the permissions of the wiki directory by running the following command:
$ sudo chmod -R 775 /var/www/html/pukiwiki/wiki/

Step 5 - Accessing PukiWiki

  1. Restart the Apache web server by running the following command:
$ sudo systemctl restart apache2
  1. Open your web browser and enter the following URL http://localhost/pukiwiki/ to access PukiWiki.
  2. Create your first page in your new PukiWiki by clicking the create page button.

Congratulations! You have successfully installed PukiWiki on your POP! OS system.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!