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…

  • Databases
  • Other
  • Productivity
  • Tools & Utilities
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
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

53/100 Fair

Maintained
76last commit 43 days ago
Popular
56628 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
201 serious finding, 20 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 21 days ago

GitHub stars
628
Open issues
61
Last commit
2026-10-09
Latest release
v0.2.3
License
MIT
Activity
stale

Checked 7 days ago - source: GitHub (GeorgeSG/KoInsight)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Use the Docker Compose block from the README Add the README's compose.yaml service so KoInsight starts in Docker, exposes port 3000 for the web UI, and saves your data in ./data; keep that folder backed up because it holds your database and settings. source
  • Put the KOReader plugin in the right folder Place the koinsight.koplugin folder inside KOReader's plugins directory using the exact layout shown, because KOReader only loads plugins from that location and a wrong path means it will not appear. source
  • Port 3000 is for the web UI The Docker Compose block maps port 3000, which is the app's web address; if you access KoInsight from another device and can't reach it, make sure that port is open or not blocked by your network. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

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.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads