Server Settings - General
Networking Section
Host Name
If you are using a reverse proxy with Kavita, you can set this field so that Kavita uses your domain name. This will show up in the user’s OPDS URL pages and any emails your server sends out, if configured to do so.
Base URL
This setting can not be changed if you are running the docker image as a non-root user.
Default: /
Base URL must start and end with /
Use this if you want to host Kavita in a sub-folder. Most commonly used in sub-folder reverse proxy setups.
Example:
Setting the base URL to /kavita/ would then make your URL to access the service: http://[yourip]:[port]/kavita/
IP Address
This is the IP address that Kavita will bind to. By default, Kavita will bind to all available IP addresses. If you want to bind to a specific IP address, you can set it here.
This setting is disabled on Docker installations. You can control the IP address through the Docker run command or compose file if needed.
Port
This setting can not be changed if you are running the docker image as a non-root user.
Default: 5000
Changes to the port require a manual restart of the server to take. Docker users should configure the port through their compose file / run command instead of changing it within Kavita.
System Section
Days of Backups
Default: 30
The number of days worth of backups to maintain. The minimum is 1, maximum is 30.
Days of Logs
Default: 30
The number of days worth of logs to maintain. The minimum is 1, maximum is 30.
Logging Level
For selecting the granularity of the logs. Most commonly used in helping diagnose problems or bugs.
Default: Information
Changing this setting to Debug or higher can consume a large amount of disk space on an active server. Only change the log level if asked by support staff!
Cache Size
Default: 75
Amount of RAM to allocate for keeping heavily used API’s in memory. Keep in mind that using dynamic filters has a higher chance of not getting cached due to the nature of how they work.
OPDS support
Default: Enabled
System wide setting to turn on or off OPDS for the entire server. See this page for how it works.
Enable Kobo Sync v0.9.2
Default: Enabled
System wide setting to turn on or off Kobo Sync for all users on the server. See this page for how it works.
Kepubify Path v0.9.2
Path to the kepubify executable, used by Kobo Sync to convert epubs to kepubs. Kavita ships with the binary, you can override if you need to. Kavita tells you whether it can run the executable at the path you entered.
Folder Watching
Default: Disabled
You can turn on or off the folder monitor system-wide here. Allows Kavita to monitor Library Folders to detect changes without manually invoking scans or waiting for nightly scans.
The folder monitor only triggers once every 10 minutes before processing changes. That means changes won’t be instant.
Allow Anonymous Usage Collection
The data collection task will only run after 24 hours has passed in order to give you time to opt-out.
By default, Kavita will collect anonymous usage data to help guide the development team into making decisions around features. This includes information on certain features used, number of files, OS version, Kavita install version, CPU, and memory.
You can opt out at any time by turning off this setting. 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 choose to remain opted-in, thank you ❤. It greatly helps in the design and planning effort when trying to look for new features to add. You can see exactly what data we collect in the source code .
Check the FAQ to see an example of submitted data.