Overview
Find your symptom in the tables and jump to the right page. Many messages in GoodWorkshop are whole sentences; the help pages quote them word for word so that the search at the top finds them. Just copy the text you see into the search.
Signing in
Section titled “Signing in”| Symptom | Page |
|---|---|
| No e-mail arrives after Send a sign-in link | Sign-in and sign-in link |
| “This link has expired or has already been used. Ask for a new one.” | Sign-in and sign-in link |
| “The link was incomplete. Ask for a new one.” | Sign-in and sign-in link |
| No Sign in with a passkey button, but “Passkeys need HTTPS …” instead | Sign-in and sign-in link |
| “The passkey could not be confirmed.” | Sign-in and sign-in link |
| “This invitation is no longer valid” | Sign-in and sign-in link |
| “Please sign in.” in the middle of your work | Sign-in and sign-in link |
AI assistant
Section titled “AI assistant”| Symptom | Page |
|---|---|
| Claude or ChatGPT can’t reach the server | AI connection |
HTTP 401 with invalid_token |
AI connection |
HTTP 429 with rate_limited |
AI connection |
| Error on the Allow access? page | AI connection |
This token does not have the "…" scope. |
AI connection |
The call failed. The operator can find the cause in the server log … |
AI connection |
| Revoking OAuth access | Known issues |
Working in the agenda
Section titled “Working in the agenda”| Symptom | Page |
|---|---|
| “No connection. Your changes will be sent as soon as it is back.” | Live editing together; self-hosted: HTTPS and reverse proxy |
| “Somebody else has changed this workshop in the meantime.” | Live editing together |
| “Contains formatting. Editing comes with the text editor …” | Known issues |
| “This workspace is read-only.” (cloud) | Pricing and billing |
Self-hosting
Section titled “Self-hosting”| Symptom | Page |
|---|---|
GW_APP_URL must be set at startup |
Installation |
| Caddy doesn’t start, “GW_HOSTNAME muss gesetzt sein …” | HTTPS and reverse proxy |
| The certificate isn’t issued | HTTPS and reverse proxy |
| No setup key in the log, or “That setup key is not correct.” | Sign-in and sign-in link |
/api/health answers 503 with database |
The database isn’t reachable or is still starting — wait a moment, see Installation |
/api/health answers 503 with migrations |
Upgrading and backups |
migrate aborts with “MIGRATION STOPPED” |
Upgrading and backups |
Graph answers 403 or invalid_client |
Sign-in and sign-in link |
| Restoring a backup, mail credentials are empty | Upgrading and backups |
| The interface is in the wrong language | Profile and language |
Nothing fits?
Section titled “Nothing fits?”- What deliberately doesn’t work yet is listed under Known issues.
- How to reach us or the operator of your installation is described under Support.