# BookOrbit

> A self-hosted library to read and listen, synced to Kobo and iPhone.

- Page: https://cgt.octabyte.io/templates/bookorbit/
- Category: Reading & bookmarks
- Replaces: Kindle, Goodreads and Audible
- Ease of use: Easy. Enter the setup token Cloudgate shows on the app's variables page, create the admin account, then add a library and upload your books in the browser.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: AGPL-3.0-only
- Good for: Readers and households with DRM-free ebooks, comics and audiobooks who want one library synced across devices
- Official website: https://bookorbit.app
- Documentation: https://bookorbit.app/installation
- Source code: https://github.com/bookorbit/bookorbit
- Last updated: 2026-11-20

## What is BookOrbit?

BookOrbit, the successor to BookLore, is a self-hosted library for ebooks, comics and audiobooks, with your place synced to Kobo, KOReader and iPhone.

BookOrbit is a free, open-source, self-hosted library for the ebooks, PDFs, comics and audiobooks you own: it keeps them on a private website where you read or listen in the browser, instead of in a store's cloud such as Kindle or Audible. It is the official successor to BookLore.

You upload your books in the browser, and BookOrbit fills in covers, authors and series from online sources. Your place in each book stays in sync between a Kobo e-reader, KOReader, the BookOrbit iPhone app and the web reader, and your ratings, reading dates and goals stay on your own server rather than on a site like Goodreads. A family, for example, could share one library with separate reading histories: one listens to an audiobook on the commute while another finishes a novel on a Kobo.

Each person gets their own account, and reading apps can open the library through its OPDS catalogue. There is no store: you bring your own DRM-free files. The iPhone and Apple Watch app is free, with an optional paid Premium upgrade, and there is no Android app yet.

Cloudgate installs BookOrbit and its database on a server Cloudgate provides or one you connect, and gives it a secure web address. Enter the setup token Cloudgate shows and create your admin account.

## What you can do with BookOrbit

- **Read and listen in the browser**: Open EPUB, MOBI, AZW3 and PDF books, CBZ and CBR comics, and M4B or MP3 audiobooks in the web page, with nothing to install.
- **Keep your place on every device**: Reading progress and highlights sync both ways with Kobo e-readers, KOReader and the BookOrbit iPhone app.
- **Covers and details filled in for you**: BookOrbit looks up covers, authors, series and descriptions from sources such as Google Books, Open Library and Hardcover, and you can edit many books at once.
- **Libraries, collections and Smart Scopes**: Keep separate libraries, group books into collections, and save filters as Smart Scopes that work as shelves that update themselves.
- **Track your reading**: Rate books, log when you started and finished, and follow reading time, streaks, yearly goals and achievements on your own statistics pages.
- **Highlights in one place**: Collect highlights from every device, export them as Markdown, CSV or JSON, and send them to Readwise; reading status can go to Hardcover and The StoryGraph.
- **A library for the whole household**: Each person gets their own account, libraries and reading history, and you can sign in with Authentik, Keycloak or Authelia.
- **Reading apps and e-readers**: A private OPDS catalogue lets KOReader, Thorium, Moon+ Reader and other reading apps open your library.

## Replaces Kindle, Goodreads and Audible

BookOrbit does the same job as Kindle, Goodreads and Audible. Here is what changes when you switch.

### What you gain

- Ebooks, comics and audiobooks from any shop or source in one private library, with no subscription
- Your place and highlights follow you between a Kobo, KOReader, an iPhone and the browser
- Your reading history, ratings and statistics stay private on your own server
- Books stay ordinary files that you can download at any time

### What is different

- There is no store; you bring your own DRM-free files, and Kindle and Audible purchases can't be imported
- It tracks your own reading but has no friends, community reviews or recommendations like Goodreads, and no Goodreads import
- The phone app is for iPhone and Apple Watch only for now, and its extras need a paid Premium upgrade
- BookOrbit is a young project that changes quickly, with new releases most weeks

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=bookorbit

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. BookOrbit itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up BookOrbit.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is BookOrbit free?

Yes, the BookOrbit server is free, open-source software under the AGPL-3.0 licence with a few added attribution terms, and has no paid edition; you pay only for your server. The iPhone and Apple Watch app is free to download, with an optional paid Premium upgrade for extras such as unlimited downloads and Apple Watch listening.

### Is BookOrbit the successor to BookLore?

Yes, BookLore's maintainers now point users to BookOrbit as its official successor, and BookLore is in maintenance mode with occasional fixes. BookOrbit is a separate, newly written app rather than a copy of BookLore's code, so it looks and works differently.

### Can I move my BookLore library to BookOrbit?

Yes, BookOrbit has a one-time import from BookLore. Your book files are added to BookOrbit first, then the import brings over metadata, covers, reading status, ebook and audiobook progress, bookmarks, annotations and shelves, which become collections. PDF annotations, book notes, Kobo device state, comic metadata and reader preferences don't move. The same tool can also import from Audiobookshelf and Calibre-Web Automated.

### How do I sign in to BookOrbit the first time?

BookOrbit has no default login; the first visit opens a setup page instead. Enter the one-time setup token that Cloudgate shows on the app's variables page, then choose a username, email and password to create the admin account.

### Does BookOrbit sync with Kobo and KOReader?

Yes, reading progress and highlights sync both ways between Kobo e-readers, KOReader and BookOrbit's web reader. A KOReader plugin also lets you browse and download books from your library on the device.

### Is there a BookOrbit app for iPhone or Android?

Yes for iPhone and Apple Watch, not yet for Android. The official BookOrbit app for iPhone and Apple Watch reads books and plays audiobooks offline, and the project says an Android app is coming; on any phone, BookOrbit also works in the browser.

### What server size do I need for BookOrbit?

A small server with 1 GB of memory is enough to run BookOrbit and its database. Plan the disk for the size of your book and audiobook collection.

### Do I need technical skills to run BookOrbit?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up BookOrbit and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for BookOrbit?

No. When you deploy BookOrbit, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
