Support

Juno needs an account on a BookOrbit server, version 3.6.0 or later. Most questions about connecting and signing in are answered below.

Questions

Which BookOrbit versions does Juno work with?

BookOrbit 3.6.0 or later. Juno follows BookOrbit’s latest release and is tested against it after each update; other versions from 3.6.0 on usually work, without a guarantee. Juno refuses an older BookOrbit at sign-in and says why: it can’t save your reading position the way Juno does. If a newer BookOrbit answers in a way Juno doesn’t understand, Juno says so where it happens.

Can I connect over plain http?

Only on your home network: a .local name, a one-word name such as nas, or a private IP address such as 192.168.1.20. Anywhere else, iOS needs https, so enter the server’s https:// address.

If you use Tailscale: iOS blocks plain http to Tailscale addresses (100.x.y.z). Turn on HTTPS for your tailnet and sign in with the server’s https Tailscale name, such as https://books.your-tailnet.ts.net.

My server uses a self-signed certificate

Juno can’t use self-signed certificates. The server needs a certificate from an authority your iPhone or iPad trusts, such as Let’s Encrypt or Tailscale’s HTTPS certificates. If Juno says the certificate has expired or isn’t valid yet, check the device’s date and time, or ask the server’s administrator to renew it. Juno doesn’t support servers that ask for a client certificate.

Can I sign in with single sign-on?

Not yet. Juno signs in with your BookOrbit username and password; single sign-on (OIDC) isn’t supported. If your BookOrbit has password sign-in turned off, Juno can’t sign in: ask its administrator.

I can’t sign in

Juno says what went wrong. The usual causes:

• Wrong username or password. Use the ones you sign in to BookOrbit’s web app with.
• Account locked, or too many attempts. BookOrbit limits sign-in attempts and locks an account after repeated failures. Wait as long as Juno says, then try again.
• Not BookOrbit. Check the address: it’s the one BookOrbit’s web app opens at, including any path, such as https://example.com/bookorbit.
• The address asks for its own sign-in. A sign-in page in front of BookOrbit, from a proxy, stops Juno. Use an address that reaches BookOrbit directly.
• BookOrbit is too old. Update it to 3.6.0 or later.
• Can’t reach BookOrbit. Check that the device is on a network that reaches the server, such as your home Wi-Fi or your VPN.

Juno signed me out

BookOrbit ended the session: your password changed, the session was signed out from BookOrbit, or it went unused for too long. Juno keeps no password, so it asks you to sign in again. Your books, reading positions and settings are still in BookOrbit.

Which books can Juno open?

EPUB and kepub books, and CBZ, CBR and CB7 comics. Other formats, such as PDF, show “Format not supported yet”. When a book has several files, Juno opens its main file if it can, or else the first one it can read.

Where are my reading position and settings kept?

In your BookOrbit account: reading positions, reading status, reader settings and each library’s reading defaults. They follow you to BookOrbit’s web reader and to another device, and they stay if you delete Juno.

Contact