QuillDocs

Troubleshooting

Fixes for the problems people run into most.

The admin portal says it isn't set up

QUILL_ADMIN_PASSWORD is missing, or QUILL_SESSION_SECRET is shorter than 16 characters. Set both in .env.local and restart.

Bots get 401 errors

The key isn't in QUILL_API_KEYS, or Quill wasn't restarted after it was added. Check that the header reads Authorization: Bearer <key> with one space.

Edits disappear after a restart

The host has no persistent disk. On Docker, run with -v quill-data:/data. See Choosing a host.

A page is missing from the sidebar

It's a draft, or it isn't in any group. Open Navigation in the admin portal; pages not in the sidebar are listed on the right.