Whatbox Logo
Login for certain variables to be updated with your slot's information

Wiki > Kavita

Kavita is a fast, feature rich, cross platform reading server. Built with the goal of being a full solution for all your reading needs.

Installation

Connect to your slot with SSH

  1. Download the latest version with wget https://github.com/Kareadita/Kavita/releases/latest/download/kavita-linux-x64.tar.gz

  2. Extract the archive with tar xzvf kavita-linux-x64.tar.gz

  3. Copy the default configuration file cp Kavita/config/appsettings-init.json Kavita/config/appsettings.json

  4. Edit the config file with nano Kavita/config/appsettings.json, change port 5000 to 26734, save with Ctrl+x then y. 26734 has been randomly chosen for you but you can choose a different non-standard port if preferred.

  5. Make executable chmod +x Kavita/Kavita

  6. Run in screen cd ~/Kavita; screen -dmS Kavita ~/Kavita/Kavita

The first start may take 1-2 minutes before it's accessible.

Access at http://server.whatbox.ca:26734

Stop and start

Stop the application

pkill -f Kavita

Start in the foreground

~/Kavita/Kavita

Start in the background

screen -dmS Kavita ~/Kavita/Kavita

Attach to running instance in background

screen -r Kavitas

Updating

  1. Remove the old archive rm kavita-linux-x64.tar.gz
  2. Shut down Kavita pkill -f Kavita
  3. Download the latest version wget https://github.com/Kareadita/Kavita/releases/latest/download/kavita-linux-x64.tar.gz
  4. Extract the archive with tar xzvf kavita-linux-x64.tar.gz
  5. Make executable chmod +x Kavita/Kavita
  6. Run in screen cd ~/Kavita; screen -dmS Kavita ~/Kavita/Kavita

Notes

The built-in navigator cannot access the root of the server. To add your directory, directly enter the path you want to use into the path bar, for example /home/user/files

To add HTTPS and add to your Managed Links for a customized URL visit your Domain page.

Automatically Restart (optional)

  1. Make a file to be used for the script. touch ~/kavita_restart.cron
  2. Edit the file and enter the text below. nano -w ~/kavita_restart.cron
#!/bin/bash
if pgrep -fx "Kavita" > /dev/null
then
    echo "Kavita is running."
else 
    echo "Kavita is not running, starting Kavita"
    screen -dmS Kavita ~/Kavita/Kavita
fi
exit
  1. Save the file with Ctrl+x and the "y" and Enter to accept overwriting.
  2. Make the script executable. chmod +x ~/kavita_restart.cron
  3. Open your crontab. EDITOR=nano crontab -e
  4. Enter the following text
@reboot /home/user/kavita_restart.cron >/dev/null 2>&1
*/5 * * * * /home/user/kavita_restart.cron >/dev/null 2>&1
  1. Save the crontab with Ctrl+x and the "y" and Enter to accept overwriting.