How to Install Klaus on Fedora Server

Klaus is a simple, easy-to-use and powerful Git web viewer. In this tutorial, we will guide you through the process of installing Klaus on Fedora Server.

Requirements

A Fedora Server (ideally, the latest version)
A user account with sudo privileges

Installation Steps

Update system
```
sudo dnf update -y
```

Install the following packages:

sudo dnf install -y python3-git python3-setuptools python3-flask python3-flask-basicauth uwsgi uwsgi-plugin-python3

Clone the Klaus repository from GitHub:

git clone https://github.com/jonashaag/klaus.git

Create a virtual environment:
```
cd klaus
python3 -m venv klaus_venv
```
Activate the virtual environment:
```
source klaus_venv/bin/activate
```
Install the Klaus application and its dependencies using pip:
```
pip install klaus
```
Copy the example klaus configuration file to /etc/klaus.cfg:
```
sudo cp example/klaus.cfg /etc/klaus.cfg
```

Edit the configuration file:

sudo nano /etc/klaus.cfg

Replace the following lines:

#SECRET_KEY = 'changeme'
#USE_SMARTHTTP = False

with:

SECRET_KEY = 'your_secret_key'
USE_SMARTHTTP = True

(use any random string as your secret key)

Create a systemd service file:

sudo nano /etc/systemd/system/klaus.service

Add the following contents and save the file:

[Unit]
Description=Klaus Git Web Viewer
After=network.target

[Service]
User=nobody
Group=nobody
WorkingDirectory=/root/klaus/
Environment="PATH=/root/klaus/klaus_venv/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin"
ExecStart=/usr/bin/uwsgi --socket :3031 --wsgi-file /usr/lib/python3.9/site-packages/klaus/wsgi.py --callable app --processes 2 --threads 4
Restart=always

[Install]
WantedBy=multi-user.target

Start and enable the service:

sudo systemctl start klaus.service
sudo systemctl enable klaus.service

Open Firewall for Port 3031:

sudo firewall-cmd --add-port=3031/tcp --permanent
sudo firewall-cmd --reload

Testing the Installation

Open up your web browser and go to http://:3031/ to access your Klaus Git web viewer.

Congratulations! you have successfully installed Klaus on your Fedora Server. Now you can easily manage your remote Git repositories using the web interface provided by Klaus.