Files & storage
Set up BookStack
Connect a BookStack wiki on your own server and every page the token can see becomes a document carrying its book and chapter, so answers point back to the right shelf. Drafts are left out. Read-only.
Before you start
- A BookStack API token, which comes as a pair: open your avatar → Edit Profile → API Tokens → Create Token — the account needs the Access system API permission. Copy both the Token ID and the Token Secret; the secret is shown only at creation, and if it is lost, delete the token in BookStack and create a new one.
- The token reads exactly what its owner can read, and only ever reads — nothing in BookStack is changed.
- Documents → BookStack: enter the address you open BookStack on in the browser, including https://, under Server URL — the API lives under /api on the same host.
- Paste the two halves into API token ID and API token secret.
- Choose access groups, Test, then Sync.
What comes in
- Every non-draft page the token can see becomes one document headed by its title, with a Book line and a Chapter line above the body — BookStack's own Markdown when the page was written in it, its HTML reduced to plain text otherwise — dated by the page's last update.
- Pages are listed most recently updated first, and the body is fetched only for pages whose updated stamp moved. Book and chapter names are read for up to 2,000 of each; a page in one beyond that carries no book or chapter line.
Access
Access is allow-only: BookStack exposes no per-page viewer list through this connector, so every page the token reads is visible here to the access groups chosen on the source. Give the token's account a viewer role scoped to the shelves that should be searchable, since that role — not a per-source setting — is what actually narrows it: the token reads exactly what its owner can read.
Test reports the number of books the token can see; it fails with a specific reason when BookStack rejects the token pair or the server address can't be reached. Pages re-read only when their updated stamp moves. An instance larger than 5,000 pages syncs its 5,000 most recently updated pages, says so in the sync summary, and keeps what already synced from the rest rather than reading the overflow as deleted.
Last updated 20 Sep 2026