How to back up your ebook library
Everything a Readwyn library holds is in its data folder, so that's the folder to back up. Add your My Words folder and the small file owner-id. Leave out the caches, which Readwyn rebuilds, and the Wiktionary download, which you can fetch again. Quit Readwyn before the backup runs, and turn off Readwyn server if it's on. The app doesn't run, schedule, or check backups itself, so the copying is up to your own backup tool.
| What | Where on a Mac | Back up |
|---|---|---|
| Each library | ~/Library/Application Support/readwyn/Libraries/; the folder button in Settings › Libraries opens it | Yes |
| My Words | ~/Library/Application Support/readwyn/My Words/ | Yes |
| The owner ID | ~/Library/Application Support/readwyn/owner-id | Yes |
| Dictionaries | ~/Library/Application Support/readwyn/Dictionaries/ | No |
| Caches | ~/Library/Caches/readwyn/ | No |
If you installed from the Mac App Store, the ~/Library/ folders in the table sit inside the app's container: ~/Library/Containers/com.readwyn.Readwyn/Data/Library/.
Finding the data folder
Each library has its own data folder. In Settings › Libraries, click the folder button (“Show in Finder”) on a library's row and Finder opens it. When a data folder is on another drive, the line under the library's name ends with that drive (“1,206 books · 41.0 GB · on “Shelf””), so you know which drive your backup has to include. With more than one library, back up each folder.
Everything that makes up the library is in two subfolders:
log/: every change as one record, such as a book added, a title set, or a book finished.blobs/: the book files and the covers, each stored under the hash of its content.

My Words and the owner ID
Words you save from a lookup belong to the app rather than to one library, so they aren't in any data folder. Back up My Words/ in the app folder.
owner-id is tiny, but every record in the log names the owner ID of the server that wrote it. Keep it with the libraries.
What to leave out
- Caches. The cache folder holds the SQLite cache and the cover thumbnails, among other things. Readwyn rebuilds the SQLite cache from the log.
- Dictionaries. After a restore, download Wiktionary again from Settings › Reading › Look up (about 900 MB).
Quit Readwyn first
If Readwyn is running while the backup takes its copy, the snapshot can end up with a log record whose book file or cover is missing.
Quitting isn't enough if Readwyn server is on (Settings › Other devices). The server keeps running after you quit, and a paired Mac can still change the library. Turn it off while the backup runs.
Why incremental backups stay small
The library is built so that an incremental backup only picks up what changed:
- Each change is appended to the log. Readwyn starts a new log file at every launch and never touches it again after the app quits.
- A book file or cover never changes once it's stored.
- Metadata isn't written into the book files. Editing a title adds one record to the log.
The exception is “Compact” in Settings › Libraries. It deletes removed books for good, which means rewriting old log files and deleting the files and covers that only those books used. So the first backup after a compaction copies those rewritten log files again.
Your Kobo database
Before a sync writes to a Kobo, Readwyn copies the device's database, KoboReader.sqlite. The message after the sync confirms it: “The device database is backed up.” To find those copies, use “Show backups in Finder” under “Backups” in Settings › E-readers.
On Linux
The Linux app keeps its app folder in ~/.local/share/readwyn and its caches in ~/.cache/readwyn, or in the matching folders under $XDG_DATA_HOME and $XDG_CACHE_HOME if you set them. The files inside are the same as on a Mac.