reMarkable 2 · KOReader
Install KOReader on the reMarkable 2
Enable developer mode, connect over SSH, install the Toltec package manager, and use it to install KOReader — plus how to keep it working across firmware updates.
KOReader on a reMarkable 2 is the difference between a poor ebook reader and a good one, and because the device is mature, this is the most reliable community install on this site. It is still advanced: developer mode wipes the device, then you work over SSH to set up Toltec and install KOReader through it. Keep your notebooks backed up, use the exact steps from the Toltec project for your firmware, and expect to re-run the install after firmware updates — or hold updates back.
Before you begin
-
Check the supported firmware before you update or start
Toltec tracks which reMarkable 2 firmware versions it supports, and support lags a little behind the newest release. Before installing, and before accepting any pending firmware update, check the Toltec site. Many people deliberately stay on a known-good firmware while running this.
-
Back up your notebooks first
Make sure everything on the device has synced to your reMarkable account, and export any notebook you cannot lose as a PDF. Enabling developer mode wipes the device.
-
Enable developer mode
In Settings, then "General", then "Software", turn on developer mode. This wipes the device as part of enabling it, which is why the backup comes first. After it re-provisions, developer mode gives you SSH access.
-
Find the SSH details and connect
In Settings, on the "Help", then "Copyrights and licenses" / "GPLv3 Compliance" screen, the device shows its IP address over USB and an SSH password. Connect the USB cable, then from your computer run "ssh root@10.11.99.1" and enter that password.
-
Install the Toltec package manager
Toltec is the community repository that packages KOReader and other tools for reMarkable. From the SSH session, run the current install command from the Toltec website — a single script that sets up the "opkg" package manager and the Toltec repo. Confirm it reports success.
-
Install KOReader through Toltec
Run "opkg install koreader". This pulls KOReader and its launcher. It also installs a way to switch between the reMarkable software and KOReader — often a launcher such as "remux", or an entry added to the device's menu.
-
Launch KOReader and point it at your files
From the launcher on the device, start KOReader. Use its file browser to find your documents — synced reMarkable files live under a data folder; many people also copy an ebook folder over SSH with "scp". Set a home directory so it opens there.
-
Plan for firmware updates
A reMarkable firmware update can disable developer mode or remove Toltec's changes. Before updating, check the Toltec site for whether the new firmware is supported. After updating, you generally re-run the Toltec install and "opkg install koreader". Turning off automatic updates while running this setup is common practice.
-
To remove it
Run "opkg remove koreader", then Toltec's uninstall script, or simply turn developer mode back off in Settings, which wipes the device and returns it to stock.