wiki on Debian Latest

In this tutorial, we will go through the process of installing a wiki from https://git.mills.io/prologic/wiki on Debian Latest. The wiki software we will be installing is named "Sopython".

Prerequisites

Before proceeding with the installation, you will need to have the following:

A Debian Latest installation
A general understanding of the Linux command line

Step 1 - Update the System

It is recommended to update the system before beginning the installation process. To do so, enter the following command:

sudo apt update && sudo apt upgrade

Step 2 - Install Required Dependencies

The Sopython wiki has several dependencies that need to be installed before we can proceed. To install these dependencies, execute the following commands:

sudo apt install python3 python3-dev python3-pip libpq-dev libxml2-dev libxslt1-dev libffi-dev libssl-dev

Step 3 - Clone the Git Repository

Now we need to clone the Sopython Git repository. To do so, run the following command:

git clone https://git.mills.io/prologic/wiki.git

This will create a new folder named wiki in your current directory.

Step 4 - Install Required Python Packages

Navigate to the wiki/sopython directory. Inside this directory, you will find a requirements.txt file that contains a list of required Python packages that need to be installed.

Run the following command to install these packages:

sudo -H pip3 install -r requirements.txt

This may take some time.

Step 5 - Set Up the Database

Sopython requires a PostgreSQL database to store data. If you do not have PostgreSQL installed, execute the following command:

sudo apt install postgresql

After installing PostgreSQL, create a new database and user for Sopython. To do so, execute the following commands:

sudo su - postgres
psql

This should launch the PostgreSQL shell. From within the shell, execute the following commands to create a new database and user:

CREATE DATABASE sopython;
CREATE USER sopythonuser WITH PASSWORD 'password';
GRANT ALL PRIVILEGES ON DATABASE sopython to sopythonuser;

Make sure to replace password with a strong password for the sopythonuser.

Exit the PostgreSQL shell by pressing Ctrl + D.

Step 6 - Configure Sopython

Navigate to the wiki/sopython/sopython/settings directory. Inside this directory, you will find a local_settings.py.example file. Make a copy of this file and name it local_settings.py.

cp local_settings.py.example local_settings.py

Edit the local_settings.py file with your text editor of choice. Replace the following variables with the appropriate values:

SECRET_KEY: a secret key for your application
DATABASES: the settings for your PostgreSQL database

Step 7 - Create Database Tables

Before we can run the wiki, we need to create the necessary database tables. To do so, navigate to the wiki/sopython directory and run the following command:

python3 manage.py migrate

Step 8 - Create a Superuser

Create a superuser for the wiki by executing the following command within the wiki/sopython directory:

python3 manage.py createsuperuser

Follow the prompts to create a new superuser account.

Step 9 - Run the Wiki

Finally, run the wiki using the following command from within the wiki/sopython directory:

python3 manage.py runserver

The wiki should now be accessible at http://127.0.0.1:8000/.

Congratulations! You have successfully installed Sopython wiki from https://git.mills.io/prologic/wiki on Debian Latest!