# 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](/docs/server/operations/index.md#logging)).

## Signing in

### The sign-in page asks for an operator token

Nobody has an Owner account yet.

1. Print the token with `cargo dev-cli -- daemon token` (or
   `bookclerk daemon token`).
2. Paste it in.
3. Create the Owner (see
   [Getting started](/docs/guide/getting-started/index.md#3-create-your-own-account)).

### The operator token is no longer accepted

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`.

### A passkey does not work

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.

### An invite link says it is invalid or expired

Invite links work once and expire. Ask whoever invited you to send a new
one from **Settings → User Management**.

## Stores

### Accounts says "No storefront plugin is deployed on this node"

The operator has not turned on any store yet. They do that in
**Settings → Plugins** (see
[Getting started](/docs/guide/getting-started/index.md#4-turn-on-your-stores)).

### The Connect button is greyed out

You are signed in as the operator. Stores belong to people, so sign in as
yourself to connect them.

### Amazon asks for a code

Your Amazon account uses two-step verification. Enter the code on Amazon's
page.

### A scan fails with "no accounts configured"

No store account is connected yet, or every connected account is turned
off for scans.

## Downloads

### Nothing downloads

Downloads happen only when someone chooses **Acquire pending**, or when
**Auto acquire** is on. Check the job list for errors.

### Downloads fail straight away

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](/docs/server/media/index.md).

### A store plugin will not start

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](/docs/internals/guest-jail/index.md#the-guest-jail).

## Branches

### Join a library says the library is not accepting new branches

On the library, an Owner or the operator turns on **Let new branches join**
in **Settings → Branches**.

### Joining fails with an insecure-connection error

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](/docs/server/branches/index.md#on-the-library-let-branches-in).
