Readwyn 0.1.0

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:

Systemx86_64arm64
Ubuntu and Debianreadwyn-server_<version>-1_amd64.debreadwyn-server_<version>-1_arm64.deb
Fedorareadwyn-server-<version>-1.x86_64.rpmreadwyn-server-<version>-1.aarch64.rpm
Other Linux systemsreadwyn-server-<version>-x86_64.tar.gzreadwyn-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

CommandWhat it does
ryn-server statusShows how many devices are connected and the addresses the server listens on
ryn-server level DEVICE LEVELSets the level of a device: guest, reading (the Read level) or admin
ryn-server remove DEVICERemoves a paired device
ryn-server versionPrints 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.