Lanraragi Integration

Connect Tsumihon to your self-hosted Lanraragi instance to search your personal manga archive and import metadata.

What is Lanraragi?

Lanraragi is a self-hosted web application for managing and reading manga and doujin archives. Tsumihon can connect to your Lanraragi instance as a search provider, letting you browse your archive and import book metadata directly.

Prerequisites

• A running Lanraragi instance (v0.8.0 or later recommended).
• The server URL must be reachable from your device.
• Your Lanraragi API key (found in Lanraragi settings).

Setup

1. Open Tsumihon and go to Settings.
2. Find the Lanraragi configuration section.
3. Enter your Server URL (e.g., http://192.168.1.100:3000 or https://lanraragi.example.com).
4. Enter your API Key.
5. Tap Save and test the connection.

Features

• Search — Browse and search your Lanraragi library from within Tsumihon.
• Import metadata — Pull title, tags, and other metadata from Lanraragi into your Tsumihon collection.
• Preview covers — View cover thumbnails from your archive.

Web App Considerations

When using the web version of Tsumihon, your browser cannot connect directly to a local Lanraragi server due to CORS restrictions. You have two options:

• Expose Lanraragi publicly with HTTPS (e.g., via a reverse proxy like Caddy or nginx).
• Use the web proxy — add your Lanraragi host to the proxy allowlist so requests are routed through the Cloudflare proxy. See the Web Proxy Setup guide.

Troubleshooting

Connection refused

• Verify the server URL is correct and includes the port number.
• Ensure Lanraragi is running and the API is enabled.
• Check that your device can reach the server (try opening the URL in a browser).

Authentication failed

• Double-check your API key in Lanraragi settings.
• Regenerate the API key if needed and update it in Tsumihon.