# KoInsight

KoInsight is a self-hosted web dashboard for KOReader reading statistics, letting users visualize stats, sync via a KOReader plugin, or upload SQLite files manually. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2963/koinsight

## Description

KoInsight is a self-hosted web dashboard for KOReader reading statistics, letting users visualize stats, sync via a KOReader plugin, or upload SQLite files manually.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

53/100 (Fair), based on 4 of 5 factors.
- Maintained: 76 (last commit 43 days ago)
- Popular: 56 (628 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 20 (1 serious finding, 20 minor, CI, tests)

## Security check

1 serious finding: Uses form-data 4.0.2, which has a known critical vulnerability.
Automated checks on commit dda2240, 30 Oct 2026. Not an audit.

## Links

- GitHub: https://github.com/GeorgeSG/KoInsight
- Unraid: https://ca.unraid.net/apps/koinsight-1jgg1uq15u1dja?q=KoInsight

## Common questions

### Which port does KoInsight use, and can it be changed?

The Docker example exposes port 3000 to the container's port 3000. You can change the server port with the PORT environment variable, and use HOSTNAME to set where the server listens.

### Where should I store KoInsight data in Docker so backups are easy?

Map a local data directory to /app/data, as in ./data:/app/data. The DATA_PATH environment variable also controls where stats and uploads are stored, with /app/data as the Docker default.

### How do I configure the KOReader plugin to sync to KoInsight?

Extract the plugin into KOReader/plugins/ so the folder is koinsight.koplugin, then open Tools > KoInsight in KOReader. Enter the KoInsight server URL, ensure the e-reader can reach it over the network, and start a sync.

### Why are book covers not shown, and how can I add them?

Covers are not part of the KOReader-generated database, so they are not automatically displayed. You can add a cover once per book by searching the title and uploading an image in the Cover Selector tab.

### Is there a limit on uploaded file size?

Yes, the MAX_FILE_SIZE_MB environment variable sets the maximum upload size in megabytes. Its default is 100 MB.

---
Source: Our Local Host (https://ourlocalhost.com/app/2963/koinsight), the self-hosted and open-source app directory.
