KOReader Tailscale Plugin for Kindle and Kobo E-Readers
A lightweight, self-contained KOReader plugin for adding Tailscale to a compatible e-reader so it can reach private services over your tailnet.
This project focuses on a practical remote access workflow: install official Tailscale ARM binaries, save an auth key, connect from KOReader, and keep the device reachable for OPDS, SSH, and self-hosted library setups.
What It Does
The plugin adds a KOReader menu for installing and updating Tailscale binaries, starting and stopping tailscaled, connecting the device to a tailnet, and checking connection status.
- Self-contained plugin directory with local binaries, state, and logs
- Kernel-TUN mode for direct network access on compatible devices
- No KUAL dependency and no extra proxy layer in the main workflow
- Downloads current ARM builds directly from Tailscale's package site
Use Cases
- Reach a private OPDS endpoint or self-hosted library from KOReader over Tailscale
- Use SSH for remote access to a jailbroken Kindle on your tailnet
- Keep an e-reader inside a private home lab or NAS workflow without exposing services publicly
- Support broader self-hosted setups that also involve Syncthing, OPDS, and SSH
Why This Repo Is Different
This repository is intentionally narrow. It is not a broad Tailscale packaging project for every e-reader scenario. It is a minimal KOReader plugin aimed at direct Tailscale connectivity where kernel TUN support is available.
That keeps the setup simpler for people who mainly want a Kindle-first workflow and a clean path to private remote access from KOReader.
Compatibility
Tested on a jailbroken Kindle Paperwhite 11th Generation (armv7l). Kobo and other KOReader devices may work when compatible kernel TUN support is available, but they are not the primary target of this repository.