Extension

Problem	Fix
Not signed in	Settings → Account — Continue with Google, Continue with email, or Sign in with SSO
401 unauthorized	Sign out and sign in again; reset password at forgot-password
SSO required	Your org requires SAML — extension: Sign in with SSO (enter org name); admin portal: Organization name + Continue with SSO on `/login`
Chat returns empty	Set Workspace owner/repo/branch; open a file for context; confirm Enable live LLM chat under Model & chat
No model picker in settings	Expected in production — models are Coop-assigned; see Model assignments
/trace or /blast disabled	Open a file in the editor first
Repo-wide /owner fails	Set owner + repo in Settings → Workspace
No integration context	Ask admin to connect tools in admin portal

Verify production

Check	Success looks like
API	api.coop-ai.dev/health returns OK
Model & chat	Four assigned models, no provider picker
Autocomplete	Ghost text on type → Tab accepts
/edit	Patch notification with Apply / Undo
Quick action	Structured answer with repo/integration context
Plain chat	Grounded reply in composer

Problem	Fix
No ghost text	Confirm sidebar Autocomplete On or Enable inline autocomplete in Model & chat; sign in under Settings → Account
Manual trigger does nothing	Enable autocomplete first; use Ctrl+Shift+\ (Cmd+Shift+\ on macOS)
Competing suggestions with Copilot	Turn Coop autocomplete off, or leave it on — Coop automatically disables Copilot inline when enabled
Slow or dropped completions	Increase `requestTimeoutMs` (default 1500); check API latency; self-hosted API needs `MISTRAL_API_KEY` for Codestral FIM
401 on completions	Sign in again under Settings → Account; automation API keys do not replace user sign-in
Graph context not applied	Deep-Index the repo in admin portal; set `coopAI.autocomplete.useGraphContext` to `true`; set Workspace owner/repo/branch
FIM not used	Ensure `coopAI.autocomplete.useFim` is `true`; operator sets `MISTRAL_API_KEY` on API server for Codestral
Workspace kept autocomplete off	Coop clears workspace `false` overrides on activate; set `coopAI.autocomplete.enabled` in User settings

Problem	Fix
Cannot sign in	Use email/password or Google from signup or invite — not an automation API key
`email_not_verified`	Google sign-in requires a verified Google email — verify in your Google account, then retry
`rate_limited`	Too many sign-in or password-reset attempts — wait ~15 minutes, then retry
SSO required	Your org enforces SAML — admin portal: Organization name + Continue with SSO on `/login`
SAML sign-in failed	See SAML SSO troubleshooting
Invite link expired	Ask admin to resend invite from Users
503 on Connect	Coop operator must configure OAuth apps on API server
403 admin required	User needs org owner/admin role
Integration shows Connected but search empty	Configure scope → Save → Test

Problem	Fix
Redirect URI mismatch	Operator: callback URL must match vendor console exactly
Slack channel picker empty	Reinstall Slack app with bot scopes; Disconnect + Connect
Google insufficient scopes	Revoke at Google account permissions; re-Connect
GitHub callback fails	Verify GitHub App setup URL matches API host
Jira empty results	Set Jira site URL; check project scope

Problem	Fix
Checkout link invalid	Start fresh from Pricing
Welcome page stuck provisioning	Wait 1–2 minutes; check email; contact support
No welcome email	Check spam; sign in at admin portal login with checkout email

Problem	Fix
Health check fails	Verify `DATABASE_URL`, restart API container
LLM 502 errors	Check provider API keys in `.env.backend`
Webhooks not firing	Verify webhook URL and secret in GitHub settings
SAML SP URLs empty	Coop operator: fix server configuration — Enterprise deployment — SAML SSO

Problem	Fix
SSO required	Extension: Sign in with SSO (enter org name); admin portal: Organization name + Continue with SSO on `/login`
`sso_not_configured`	Admin: Settings → Single sign-on → save IdP config with Enable SSO checked
`saml_validation_failed`	Check IdP cert expiry, Entity ID / ACS URL match, server clock skew
`sso_required_active`	Turn off Require SSO before disabling SAML
SP URLs empty in admin	Coop operator: fix server configuration — Enterprise deployment — SAML SSO
IdP-initiated login fails	Coop is SP-initiated only — start from admin Test connection or extension Sign in with SSO
Browser handoff fails (extension)	Complete IdP login in browser; see callback errors in Extension settings — Enterprise SSO

Full error code table and known limits: SSO troubleshooting.

Coop operators (self-hosted or support): post-deploy validation steps in Enterprise deployment — SAML SSO.