Troubleshooting
Find your problem below, then follow its fix. If none of these fit, the operator can look at Bookclerk's log in the terminal or system log (see Running Bookclerk).
Nobody has an Owner account yet.
- Print the token with
cargo dev-cli -- daemon token(orbookclerk daemon token). - Paste it in.
- Create the Owner (see Getting started).
Once an Owner exists, the sign-in page no longer accepts the token. Sign in as the Owner instead.
On the computer that runs Bookclerk, the operator can still get a one-time
sign-in link from the tray icon's Copy sign-in link, or from
bookclerk login.
Open Bookclerk at http://localhost:8787, not http://127.0.0.1:8787.
Passkeys need a name, not a number.
On a server, the operator must set the library's public address.
Invite links work once and expire. Ask whoever invited you to send a new one from Settings → User Management.
The operator has not turned on any store yet. They do that in Settings → Plugins (see Getting started).
You are signed in as the operator. Stores belong to people, so sign in as yourself to connect them.
Your Amazon account uses two-step verification. Enter the code on Amazon's page.
No store account is connected yet, or every connected account is turned off for scans.
Downloads happen only when someone chooses Acquire pending, or when Auto acquire is on. Check the job list for errors.
Bookclerk handles audio in a separate, locked-down helper program,
bookclerk-media-worker, and refuses to handle audio without it.
If you built Bookclerk yourself, make sure that helper sits next to
bookclerkd. cargo dev does this for you. See
Media worker.
Plugins run in their own locked-down process through bookclerk-jail and
bookclerk-workerd. Both must also sit next to bookclerkd. See
The guest jail.
On the library, an Owner or the operator turns on Let new branches join in Settings → Branches.
A branch only connects to a library over HTTPS, except on the same computer. The library's operator sets that up; see Libraries and branches.
Source: docs/guide/troubleshooting.md at main · View as Markdown