WackoWiki is a free and open-source wiki software that allows you to create and edit online documentation, as well as collaborate with others. This tutorial will guide you through the process of installing WackoWiki on an Ubuntu Server.
Before proceeding with this tutorial, you will need:
The first step is to update your system to ensure that all packages are up to date. Open your terminal and enter the following command:
sudo apt update && sudo apt upgrade -y
WackoWiki requires a web server, PHP, and a database server to run. In this tutorial, we will use Apache2, PHP, and MariaDB, respectively.
To install Apache2, enter the following command:
sudo apt install apache2 -y
To install PHP, enter the following command:
sudo apt install php libapache2-mod-php -y
To install MariaDB, enter the following command:
sudo apt install mariadb-server mariadb-client -y
During the installation process, you will be prompted to set a root password for MariaDB. Make sure to remember this password, as you will need it later.
Next, we need to create a new database and user for WackoWiki. Log in to MariaDB using the following command:
sudo mysql -u root -p
You will be prompted to enter the root password you set earlier. Once you're logged in, enter the following commands to create a new database and user:
CREATE DATABASE wackowiki;
CREATE USER 'wackouser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wackowiki.* TO 'wackouser'@'localhost';
FLUSH PRIVILEGES;
exit;
Make sure to replace password
with a strong password of your choice.
Download the latest version of WackoWiki from the official website:
wget https://github.com/wackowiki/wackowiki/archive/refs/tags/6.6.6.tar.gz
Extract the downloaded file to the Apache2 web root directory:
sudo tar -xzf 6.6.6.tar.gz -C /var/www/html/
Rename the extracted directory to something more user-friendly:
sudo mv /var/www/html/wackowiki-6.6.6 /var/www/html/wiki
First, we need to grant write permissions to the cache
and config
directories:
sudo chown -R www-data:www-data /var/www/html/wiki/cache
sudo chown -R www-data:www-data /var/www/html/wiki/config
Next, we need to copy the sample configuration file and make some changes:
cd /var/www/html/wiki/
sudo cp config/config.dist.php config/config.php
sudo nano config/config.php
Find the following lines in the configuration file:
define('DB_DSN', '');
define('DB_USER', '');
define('DB_PASSWORD', '');
Replace them with the following lines, using the database name and user credentials you created earlier:
define('DB_DSN', 'mysql:host=localhost;dbname=wackowiki;charset=utf8mb4');
define('DB_USER', 'wackouser');
define('DB_PASSWORD', 'password');
Save and exit the file.
WackoWiki uses mod_rewrite to handle URLs. To enable this module, enter the following command:
sudo a2enmod rewrite
Then, restart the Apache2 service:
sudo systemctl restart apache2
Open your web browser and navigate to the following URL:
http://your-server-ip/wiki/install.php
Follow the on-screen instructions to set up your WackoWiki installation.
Once the installation is complete, navigate to the following URL to access your WackoWiki site:
http://your-server-ip/wiki/
Congrats! You have successfully installed WackoWiki on your Ubuntu Server. You can now begin adding content, configuring settings, and collaborating with others. For more information on how to use WackoWiki, refer to the official documentation.
Stay safe and happy coding!
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!