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…
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.
Security check: 1 serious finding
- Uses form-data 4.0.2, which has a known critical vulnerability (npm)
Automated checks on commit dda2240, 30 Oct 2026. Not an audit.
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
Variants
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
- Reddit (reddit)
Collected 49 days ago - public community threads