Tutorial: How to Install WiKiss on Fedora CoreOS

WiKiss is a wiki engine developed in PHP. In this tutorial, we will guide you on how to install WiKiss on the latest version of Fedora CoreOS.

Prerequisites

Before starting with WiKiss installation, make sure you have the following prerequisites:

A running instance of Fedora CoreOS with internet access
A user account with sudo privileges

Step 1: Install Web Server and PHP

To start with the WiKiss installation, we need to install a web server and PHP on our system. We will use the Apache web server and PHP for this purpose. Run the following command to install Apache and PHP:

$ sudo dnf install httpd php php-mysqlnd php-gd php-xml

After installing the web server and PHP, we need to enable and start the Apache service:

$ sudo systemctl enable --now httpd.service

Step 2: Install MariaDB and Create a Database

WiKiss requires a database to store its data. We will use MariaDB for this purpose. Run the following command to install MariaDB:

$ sudo dnf install mariadb-server

After installing MariaDB, enable and start the database service:

$ sudo systemctl enable --now mariadb.service

Next, we need to secure the MariaDB installation by running the following command:

$ sudo mysql_secure_installation

Follow the instructions and set a root password for MariaDB.

Now, log in to the MariaDB server and create a new database for WiKiss:

$ sudo mysql -u root -p

MariaDB [(none)]> CREATE DATABASE wikiss_db;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON wikiss_db.* TO 'wikiss_user'@'localhost' IDENTIFIED BY 'wikiss_password';
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> exit

Replace wikiss_db, wikiss_user, and wikiss_password with your preferred database name, username, and password.

Step 3: Download and Install WiKiss

Now that we have installed the web server, PHP, and MariaDB and created a database for WiKiss, we can proceed with the installation of WiKiss.

Download the latest version of WiKiss from their official website:

$ wget https://wikiss.tuxfamily.org/wikiss-latest.tar.gz

Extract the WiKiss archive and move the contents to the Apache document root:

$ tar xvfz wikiss-latest.tar.gz
$ sudo mv wikiss/* /var/www/html/

Next, copy the wikiss/config.sample.php file to wikiss/config.php and edit the new file with your preferred settings:

$ sudo cp /var/www/html/wikiss/config.sample.php /var/www/html/wikiss/config.php
$ sudo nano /var/www/html/wikiss/config.php

Update the database details with the credentials you created in step 2:

$wgDBserver = "localhost";
$wgDBname = "wikiss_db";
$wgDBuser = "wikiss_user";
$wgDBpassword = "wikiss_password";

Save the file and exit.

Step 4: Configure Firewall and Allow HTTP Traffic

By default, Fedora CoreOS has a firewall configured that blocks incoming traffic. If you want to access your WiKiss installation over HTTP, you need to allow HTTP traffic in the firewall. Run the following command to allow HTTP traffic:

$ sudo firewall-cmd --permanent --zone=public --add-service=http
$ sudo firewall-cmd --reload

Step 5: Access the WiKiss Installation

Now that you have completed the WiKiss installation, you can access your Wiki by opening a web browser and entering your server's IP address or hostname in the address bar.

http://<server_ip_address>/wikiss/

You will be greeted with the WiKiss welcome page where you can create your own pages and content.

Congratulations! You have successfully installed WiKiss on Fedora CoreOS.