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.
• ntfy, Gotify, or a personal webhook is rejected or silent: Personal Delivery Channels.
• One workspace is too noisy or unexpectedly quiet: Workspace Rules.
• 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.
• A Slack, Discord, Telegram, or Zulip channel is not receiving updates: Chat Destinations.

Running your own deployment

If the problem is the deployment itself — services not starting, routing, health checks, or configuration — see Common Issues in the Self-Hosting section.

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.
• Browser and operating-system versions when relevant.

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.