Troubleshooting
Start with the symptom below, then follow the linked guide for the checks that apply to that part of Kanera.
Account and access
- You cannot sign in or reset a password: Account Access and Sign-In.
- A person cannot open a workspace or board: Roles and Permissions.
- A guest cannot see the expected work: Guests.
Cards and content
- Editing controls are missing or a move is unavailable: Create and Manage Cards.
- Search does not return a known item: Find Work Across Kanera.
- A file will not upload: Attachments.
- A board link does not stay synchronized: Board Syncing.
Notifications
- Email, push, or sound does not arrive: Notification Configuration.
- The notification drawer does not show expected activity: Receiving Notifications.
- Watching a card or board creates too much or too little attention: Watchers.
AI agents and integrations
- An AI client cannot connect or authenticate: AI MCP troubleshooting.
- An OAuth connection fails or expires: Connect an AI agent.
- ChatGPT cannot discover or update tools: Set up ChatGPT.
- A webhook is failing: Webhooks.
Self-hosting
For a new deployment, work through the checks in Self Host - Getting Started in order:
- Confirm the required environment variables are present.
- Check that PostgreSQL and Valkey are healthy.
- Check the API and worker logs.
- Confirm the public health endpoints respond.
- Verify reverse-proxy routing and trusted public URLs.
- Test SMTP, storage, and backup configuration separately.
The implementation-backed deployment reference is DEPLOY.md.
Ask for help
When reporting a problem, include:
- What you were trying to do.
- The page and control you used.
- What you expected and what happened instead.
- Whether the problem is hosted or self-hosted.
- Browser and operating-system versions when relevant.
- Relevant self-hosted service logs with secrets removed.
Email [email protected] for support or open a GitHub issue for a reproducible software or documentation problem. Never include passwords, API keys, tokens, customer data, or private attachments.