Skip to main content

Kavita

Kavita is a self-hosted library application for comics and ebooks. It supports a vast array of file formats.

  • For more information about this app, follow this link.

Initial Setup

Configuration

  • Once the installation has been completed, you can access the Kavita web UI from the Apps tab on the UCP.
  • Log in with your Kavita service username and the password you set during the installation.
  • Our Kavita installation comes with a pre-configured library:
    • Manga - ~/media/Manga
  • Add your Manga ebooks to this library our continue reading to add a new library.

Add a Library

  • From the Kavita web UI, go to Server Settings in the top right corner.

  • Next, click the Libraries tab.
  • Then, click the Add Library button.

  • Pick a name for your library.
  • Choose a library type.
  • Then, click the Next button.

  • Click the + Browse for Media Folders button.

  • From here, you need to navigate the directory structure to find the directory you want to add as a new library.
  • Start by clicking the / row to go to the top-level directory.

  • Next, find and click on the home directory.
  • Then click on the directory of your username and navigate to the directory you want to add as a new library.
  • For this guide, we will use /home/username/media/Comics as an example.
  • When you have navigated to the directory of your choice, click the Share button in the bottom right corner.

  • Click the Next button.
  • On this page, you can add an optional library cover image.
  • Add an image, or proceed by clicking the Next button again.
  • On the last page, you can choose to enable or disable some library settings. We recommend keeping all settings at the default enabled state.
  • Click the Save button in the bottom right corner.

  • If done correctly, a notification will appear in the bottom right corner that confirms a new library has been successfully created.

Add a User

  • If you want to add another user to Kavita, head over to the Server Settings again.

  • Click the Users tab.
  • Click the + Invite button.

  • Type the email address of the person you want to invite.
  • Select what libraries to share with the person.
  • Lastly, click the Invite button in the bottom right corner.
  • Done!

External Readers

You can also access your Kavita ebook library from a third-party ebook reader such as Moon+ Reader. Go here for a list of third party ebook readers that are confirmed compatible with Kavita.

  • In the box below, you will find the connection details needed to access your Kavita ebook library from a third-party ebook reader.
    • Make sure to replace <username> and <hostname> with your specific details, which can be found on the UCP.
Host: https://<username>.<hostname>.usbx.me/kavita
Port: 443
Username: Your Ultra.cc username
Password: Kavita password

Moon+ Reader

  • Go to the Google Play store, download and install Moon+ Reader.
  • When you first open the app, you will need to allow "All files access" permission to the app, as shown in the below image.

  • Click OK to open internal permission settings.

  • Find Moon+ Reader in the list and enable "All files access", as shown in the above image.
  • Next, go back to the Moon+ Reader app to add access to your Kavita ebook library.

  • In the expandable menu, click on Net Library, as shown in the above image.

  • Next, click the three dots icon in the top right corner.
  • In the menu that appears, click Add new catalog, as shown in the below image.

  • You will be presented with a form where you can add Catalog Name and Catalog URL.

  • Catalog Name can be set to whatever you please.
  • Catalog URL needs to be set to https://username.hostname.usbx.me/kavita
    • Make sure to replace http:// with https://
    • Make sure to replace username and hostname with your Ultra.cc service specific username and hostname.
  • Click OK to proceed.

  • You should now see your Kavita ebook library added at the bottom of the Net Library. In this example, we named it to Kavita.
  • Click the Kavita icon to open your Kavita ebook library.

  • If done correctly, you should be presented with a login form to access Kavita.
  • Log in with your Ultra.cc service username and the password you previously set during the Kavita installation.
  • Done!
Back to top