Initial setup
After installing Koharia, you can add a Komga, Kavita, LANraragi, or smanga server, use local folders, or configure several content sources.
1. Confirm the system requirement
Koharia requires Android 8.0 or later.
For a server, have a reachable address, the required credentials, and an account with the necessary permissions. Minimum versions and authentication differ by provider. For a local library, make sure your files are in a location that you can grant through Android's system file picker.
2. Choose a content source
When you first open the app, choose where your content is stored:
- Add Komga: Use an API key or username and password.
- Add Kavita: Use an Auth Key/API key from Kavita 0.8.0 or later.
- Add LANraragi: Use a 0.9.70+ server address and an optional API key.
- Add smanga: Use the smanga 4.3 API, credentials, and enabled OPDS.
- Use local folder: Create a local-library connection, then link existing folders or let Koharia create library folders.
These connections can coexist, and you can add another connection later from connection management.
3. Complete the matching setup
- For Komga, follow Add a Komga server to enter the address and authentication details.
- For Kavita, follow Add a Kavita server to enter the address and Auth Key.
- For LANraragi, follow Add a LANraragi server to configure Categories and Archive opening.
- For smanga, follow Add a smanga server to validate OPDS.
- For files on the device, follow Add a local library to choose the library organization, folders, and metadata storage.
4. Check your libraries
After setup, verify that the shelf shows the expected content. Servers display only libraries available to the current account; a local library completes an initial scan and can be reindexed later with pull to refresh.
5. Adjust settings as needed
Before you begin reading, adjust library display, reader, and download options in Settings. If you plan to download a large amount from a server, choose an appropriate download location first and use Wi-Fi or charging when possible; Komga also offers per-server and shared download-directory modes.