How to Install WiKiss on Linux Mint

WiKiss is a simple, lightweight wiki engine that can be installed on Linux Mint. This tutorial will show you how to install WiKiss on Linux Mint.

Prerequisites

  • A computer running Linux Mint
  • A web server already installed (such as Apache or Nginx)
  • PHP 7.2 or higher
  • Git installed on your system

Step 1: Install Git

To install Git, run the following command in the terminal:

sudo apt-get update
sudo apt-get install git

Step 2: Clone the WiKiss Repository

Next, you need to clone the WiKiss repository. To do this, navigate to the web server's root directory, then run the following command:

cd /var/www/html/
sudo git clone https://framagit.org/wikiss/wikiss.git

Step 3: Configure the Wiki

After cloning the WiKiss repository, navigate to the newly created wikiss directory:

cd wikiss/

Next, copy the config.example.php file to config.php:

cp config.example.php config.php

Open config.php in your preferred editor and configure your wiki settings as needed. Here are a few of the most important settings to configure:

  • TITLE: The title of your wiki
  • DEFAULT_LANG: The default language for your wiki
  • ALLOWED_LANGS: An array of the allowed languages for your wiki
  • SESSION_SECRET: A secret key to use for session encryption (you should generate a random string for this)
  • RESTRICT_EDIT_DELETE: Set to true to require users to be logged in to edit or delete pages
  • MAIL_FROM: The "From" address for email notifications
  • SMTP_SERVER: The SMTP server to use for email notifications (if using a local SMTP server, you may need to install msmtp and configure it for your email account)

Step 4: Configure Apache

If you're using Apache, you need to create a virtual host for your wiki. Create a new file in the sites-available directory:

sudo nano /etc/apache2/sites-available/wiki.conf

Add the following content to the file, adjusting the ServerName, DocumentRoot, and Directory directives as needed:

<VirtualHost *:80>
    ServerName example.com
    DocumentRoot /var/www/html/wikiss
    <Directory /var/www/html/wikiss>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Save and close the file, then enable the new virtual host:

sudo a2ensite wiki.conf

Restart Apache to load the new configuration:

sudo systemctl restart apache2

Step 5: Test Your WiKiss Installation

You should now be able to access your WiKiss installation by opening a web browser and navigating to your server's IP address or domain name. If everything is configured correctly, you should see the WiKiss homepage.

Congratulations, you've successfully installed WiKiss on Linux Mint!