Run a headless ebook server on Linux
ryn-server is Readwyn's server without the app. It holds your libraries on a Linux machine with no display, such as a NAS or a home server, and the Readwyn apps on a Mac or a Linux computer connect to it just as they would to a Mac, with the same Guest, Read and Admin levels. It works on the home network only.
Reader apps can't use it yet, though. No ryn-server command turns on the OPDS catalogue or adds a reader app. If you want your phone's reader app to browse the libraries, keep them in the Readwyn app instead (Run a home ebook server on a Mac).
Choose the package
The server comes as a deb, an rpm and a tar file, for x86_64 and arm64:
| System | x86_64 | arm64 |
|---|---|---|
| Ubuntu and Debian | readwyn-server_<version>-1_amd64.deb | readwyn-server_<version>-1_arm64.deb |
| Fedora | readwyn-server-<version>-1.x86_64.rpm | readwyn-server-<version>-1.aarch64.rpm |
| Other Linux systems | readwyn-server-<version>-x86_64.tar.gz | readwyn-server-<version>-aarch64.tar.gz |
The tar file holds ryn-server, the systemd unit [email protected] and a README. The download page lists every file.
Start it
The deb and rpm packages install the systemd unit [email protected]. Enable it for your user (put your user name in place of USER):
sudo systemctl enable --now readwyn-server@USER
From then on the server starts with the machine, even when nobody logs in, and systemd restarts it after a crash.
On its first start it listens on every network, on port 7313, because its whole job is serving other devices. ryn-server listen local limits it to the machine itself, and ryn-server listen all opens it up again. Put a port number after either to change the port.
Pair the Readwyn app
As the server's user, make a pairing code:
ryn-server code
The code has six digits and works once, for 10 minutes. It gives the Read level unless you ask for another with ryn-server code guest or ryn-server code admin. In Readwyn, open Settings › Other devices › Another device, type the server's address and click Connect. Six boxes then appear for the code; enter it and click Pair, and the app shows the server's libraries.
A device can also ask to pair without a code. ryn-server devices lists the paired devices and any requests waiting, and ryn-server allow DEVICE or ryn-server deny DEVICE answers one.
The other commands
| Command | What it does |
|---|---|
ryn-server status | Shows how many devices are connected and the addresses the server listens on |
ryn-server level DEVICE LEVEL | Sets the level of a device: guest, reading (the Read level) or admin |
ryn-server remove DEVICE | Removes a paired device |
ryn-server version | Prints the version |
Each command talks to the running server over its socket, so run it as the server's user. If no server is running, the command says so and exits with status 1.
Where your libraries live
Libraries and settings go in the user's ~/.local/share/readwyn, caches in ~/.cache/readwyn. A machine without a display has no Secret Service (the keyring of a Linux desktop), so the server keeps the Goodreads sign-in token in secrets.json in the same folder, where only that user can read it. Removing the package leaves all of this in place.
Updates
When a newer server is out, the Readwyn app on a Linux computer connected to it shows an update card such as “Readwyn server 0.2.0 is out”. The new package goes on over the old one and restarts the running server itself.
A restart with nobody logged in
On 22 October 2026 the deb of each architecture ran on Ubuntu 24.04 server with no display, holding one library and one book. The Readwyn app on a Mac paired with the server through a code from ryn-server code and opened the library and its book. Then the Linux machine restarted. With nobody logged in, the server answered again, and the app reconnected by itself.