WikkaWiki is an open source, flexible and lightweight wiki engine forked from WakkaWiki.
It is writtent in PHP language and uses MySQL to store pages. It is simple, powerful, easy to use and easy to install.
WikkaWiki has been chosen by hundreds of users, projects, companies and organizations to run their websites.
In this tutorial, we will go through how to install WikkaWiki on Ubuntu 16.04 server.
Requirements
- A server running Ubuntu 16.04.
- A normal user with sudo privileges setup on your server.
Update the System
Before installing any packages, it is recommended to update your system with the latest stable version. You can do this with the following command:
sudo apt-get update -y
sudo apt-get upgrade -y
Once your system is up to date, you can proceed to install Apache web server.
Install Apache Web Server
First, you will need to install Apache web server on your system. You can easily install it by running the following command:
sudo apt-get install apache2 -y
Once apache is installed, start the Apache web server and enable it to start on boot with the following command:
sudo systemctl start apache2
sudo systemctl enable apache2
Install PHP
You can install PHP and other required modules with the following command:
sudo apt-get install wget unzip php7.0 php7.0-mysql php7.0-gd php7.0-curl libapache2-mod-php7.0 php7.0-mcrypt libssh2-php
Once all the packages are install, you can proceed to install MariaDB server.
Install and Configure MariaDb Server
You will need to install MariaDB server to store data. You can install it with the following command:
sudo apt-get install mariadb-server -y
Start MariaDB and enable it to automatically start at boot time.
sudo systemctl start mysql
sudo systemctl enable mysql
By default, MariaDB is not secured, so you will need to secure it first. You can secure it by running the mysql_secure_installation script.
sudo mysql_secure_installation
Answer all the questions as shown below:
Set root password? [Y/n] n
Remove anonymous users? [Y/n] y
Disallow root login remotely? [Y/n] y
Remove test database and access to it? [Y/n] y
Reload privilege tables now? [Y/n] y
Once MariaDB is secured, log in to the MySQL shell and create a database for wikkawiki:
mysql -u root -p
Enter your root password when prompt, then create a database for wikkawiki. It is recommended to set secure password:
MariaDB [(none)]>CREATE DATABASE wikkawiki_db;
Query OK, 1 row affected (0.00 sec)
Next, create a username and password for wikkawiki with the following command:
MariaDB [(none)]>CREATE USER 'user'@'localhost' IDENTIFIED BY 'password';
Query OK, 1 row affected (0.00 sec)
Next, grant privileges to the wikkawiki database with the following command:
MariaDB [(none)]>GRANT ALL PRIVILEGES ON wikkawiki_db.* TO 'user'@'localhost';
Query OK, 1 row affected (0.00 sec)
Next, you will need to run the FLUSH PRIVILEGES command so that the privileges table will be reloaded by MariaDB and we can use new credential:
MariaDB [(none)]>FLUSH PRIVILEGES;
Query OK, 1 row affected (0.00 sec)
Next, exit from the MariaDB console with the following command:
MariaDB [(none)]>\q
Once you are done, you can proceed to the next step.
Install Wikkawiki
You can download the latest stable version of the wikkawiki from sourceforge site.
To download it, run the following command:
http://wikkawiki.org/downloads/Wikka-1.3.7.zip
Once the download is completed extract the downloaded file with the following command:
unzip Wikka-1.3.7.zip
Next move the extracted directory to the apache web root directory:
sudo mv WikkaWiki-1.3.7 /var/www/html/wikkawiki
Next. you will need to change permissions of the wikkawiki folder:
sudo chown -R www-data:www-data /var/www/html/wikkawiki
Configure Apache web server for Wikkawiki
You will need to create a virtual host file for Wikkawiki. You can do this by creating wikkawiki.conf file inside /etc/apache2/sites-available/ directory:
`sudo nano /etc/apache2/sites-available/wikkawiki.conf
Add the following lines:
<VirtualHost *:80>
ServerAdmin admin@yourdomain.com
DocumentRoot "/var/www/html/wikkawiki/"
ServerName yourdomain.com
ServerAlias www.yourdomain.com
<Directory "/var/www/html/wikkawiki/">
Options FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>
ErrorLog /var/log/apache2/wikkawiki-error_log
CustomLog /var/log/apache2/wikkawiki-access_log common
</VirtualHost>
Save and close the file when you are finished, then enable the site with the following command:
sudo a2ensite wikkawiki.conf
Next, enable the rewrite module with the following command:
sudo a2enmod rewrite
Finaly, restart Apache web server so that the changes take place:
sudo systemctl restart apache2
Once you are finished, you can proceed to access Wikkawiki web installation wizard.
Access Wikkawiki
Before accessing the Wikkawiki Web Interface, you will need to allow HTTP service through UFW firewall.
By default UFW is disabled on your system, so you need to enable it first. You can enable it with the following command:
sudo ufw enable
Once UFW firewall is enabled, you can allow HTTP service by running the following command:
sudo ufw allow http
You can now check the status of UFW firewall by running the following command:
sudo ufw status
Next, Open your web browser and type the URL http://yourdomain.com, you should see the following page:
HP_NO_IMG/data/uploads/users/f36d03b4-5bf0-4986-8e72-2e14d73d9b4d/1940199496.png” alt=”” />
HP_NO_IMG/data/uploads/users/f36d03b4-5bf0-4986-8e72-2e14d73d9b4d/514230683.png” alt=”” />
HP_NO_IMG/data/uploads/users/f36d03b4-5bf0-4986-8e72-2e14d73d9b4d/2137979374.png” alt=”” />
Here, provide all the required informations like database name, username, password, sitename site home page, admin username and password, then click on continue
button, you should see the following page:
HP_NO_IMG/data/uploads/users/f36d03b4-5bf0-4986-8e72-2e14d73d9b4d/1495618093.png” alt=”” />
Here, review all the pre-installation requirements and click on the continue
button, you should see the following page:
HP_NO_IMG/data/uploads/users/f36d03b4-5bf0-4986-8e72-2e14d73d9b4d/216124145.png” alt=”” />
Now, click on “return to wikka site” button, you should see the Wikkawiki Dashboard in following image:
HP_NO_IMG/data/uploads/users/f36d03b4-5bf0-4986-8e72-2e14d73d9b4d/785674947.png” alt=”” />
Conclusion
Congratulations! You have successfully installed Wikkawiki on Ubuntu 16.04 server. You can now easily create your own Wiki using Wikkawiki.
Feel free to comments me if you have any question.