Use this to if you want to host kavita in a sub-folder URL, ie) yourdomain.com/kavita
Most commonly used in sub-folder reverse proxy setups.
There are a multitude of settings that can be changed. The Port and Logging Level require a manual restart of the server to take effect. On docker these settings are not configurable from the web UI.
The number of backups to maintain. Default is 30, minimum is 1, maximum is 30.
Amount of RAM to allocate for keeping heavily used API's in memory. Defaults to 75 MB.
Adjustable number of days before removing a series from "On Deck". Setting this to a higher value will prevent series from falling off with inactivity.
The number of days since last progress before kicking something off On Deck.
By default, Kavita will collect anonymous usage data on your installation. This includes information on certain features used, number of files, OS version, Kavita install version, CPU, and memory. Stats collection will run after 24 hours in order to give you time to opt out.
You can opt out at any time by turning off "Send Data" from the Admin Dashboard. All data is anonymized and contains no information about your filenames or IP.
The Kavita team actively uses this data to help design the UX and plan enhancements. If you chose to remain opted-in, thank you. It really helps in the design and planning effort. You can see exactly what data we collect here.
Check the FAQ to see an example of submitted data.
You can enable OPDS for your Server here. See this page for how it works.
You can turn on or off the folder monitor system wide here. Allows Kavita to monitor Library Folders to detect changes and invoke scanning on those changes. This allows content to be updated without manually invoking scans or waiting for nightly scans.
Note: The folder monitor only triggers once every 10 minutes before processing changes. That means addition / removals won't be instant.
From the Users Tab, admins can see the pending invites to their server and their active users.
They can quickly see information around them and modify their password, delete the user, or edit their library access or roles.
An admin cannot use this screen to modify their own roles (admin role will always have all applicable permissions) or library access (admin always has full access).
An admin can use the user settings page to change their password.
Adding and Editing Libraries is covered here.
From the Media Tab, admins can set server-wide settings for saving media formats. You can pick from PNG, AVIF or WebP.
You should check the compatibility of the devices and browsers your users have before picking a format:
WebP offers impressive compression and performance with the only draw back of limited support on older iOS devices.
This setting allows you to pick a larger resolution than the default 320x455. The options are:
Note: Changing the Cover Image Size to something larger than default will impact loading time of images, especially over remote connections.
Note: Changing the above settings will not do a conversion. Once changed, use Tasks tab to run the conversion job for all existing Bookmarks and covers.
If kavita has any problems reading the files as it scans them, those issues will show up here. This list does not automatically clear. Once you fix the files, press the Clear Alerts
button. If any issues are found on the next scan, they will be shown again here.
Some common issues are:
In this tab, you can download logs, backup the database, check for updates, and manually Clear Cache.
You can also specify when you want the library to scan itself and make backups. If Library Scan is set to Daily, it will start at midnight in your timezone. If set to Weekly, it will scan at midnight on Monday night.
System Cache is cleared automatically after a Library Scan and as a system function each night.
Note: Manually clearing system cache while other users are reading on Kavita will incur a one-time loading during the reading experience.
Kavita will remove any series from a user's want to read list, where the series has the Publication Status Completed (this implies everything is within kavita and no more issues will be released) and the user has fully read the series.
Kavita offers a quick way to see if a new version is available. From the Tasks tab, click Check for Update. A modal will appear if an update is available where you can read the new features and fixes and click Download to open Github and download the updated version. If you are on Docker, there is no Download button. Please pull the latest image yourself.
Under the System Tab, admins can track what version Kavita is running
Under the More Info section are links to Kavita-related websites. Donations are very appreciated and directly support development and web hosting.
If you need to report an issue please visit the GitHub page.
If Kavita is missing a function please visit the Feature Request link and make a new request, or vote on one you support.
To access the user settings page, which holds the all settings for the logged-in user, you can use the nav bar dropdown on your username and select "User Settings". These settings apply to the logged-in user and will not affect any other user.
This section is for managing your kavita account settings such as email address, account password, age restrictions and scrobbling providers for use in Kavita+.
In this section, the user can configure site-wide preferences like default how the chapters/volumes are displayed (cards/list) or to blur the summaries descriptions.
In the reading section, you will find all the options for the manga reader and the book reader. You can customize these as you like and they will apply on any of your devices. You can read more about each reader's setting here (manga) and here (book).
Kavita provides multiple ways to connect to your server from external applications. You can find them below:
As of v0.5.2 Kavita allows for custom themes. We have opened up some elements to change via CSS variables. Please read the Themes page below for further info:
This section is for you to setup devices that cannot connect to Kavita via a web browser and instead have an email address that accepts files.
You can setup predefined email addresses to use with kindles, kobo or pocketbook devices.
Note: You need to setup and run your own kavita email instance for this to work. You can not use the default email service for sending files to your devices.
The list of smart filters you have created on your account will appear here. You have the option of deleting them if you no longer need them.
Your individual stats customized just for you are displayed here.
Here you will find any scrobble events linked with your account when using the Kavita+ feature. All events that have been processed will clear after a month.
Any series that you block scrobbling from on the series page will show up here as a hold. You can remove a series at any time and the next scrobble-able event (reading progress, rating, want to read status) will trigger events.
In the reading section, you will find all the options for the manga reader and the book reader. You can customize these as you like and they will apply on any of your devices. You can read more about each reader's setting here (manga) and here (book).