How to Get Support for Kaneo: 7 Official Channels and Community Resources
Kaneo offers official support through Discord, GitHub Issues, documentation, and a built-in MCP endpoint for programmatic assistance.
The open-source project management platform provides multiple pathways for users to resolve issues, report bugs, and engage with the core team. Whether you're running a self-hosted instance or contributing code, understanding how to get support for Kaneo efficiently will save time and connect you with the right resources.
Official Documentation and Self-Service Resources
The fastest way to resolve common issues is through Kaneo's comprehensive documentation and repository files.
Primary Documentation Site
Browse the official docs at https://kaneo.app/docs/core for in-depth guides covering:
- Installation and configuration
- API usage patterns
- Troubleshooting common deployment issues
This link appears prominently in the repository's [README.md](https://github.com/usekaneo/kaneo/blob/main/README.md), making it the first stop for new users.
Repository Reference Files
Several markdown files in the usekaneo/kaneo repository provide structured guidance:
| File | Purpose |
|---|---|
[README.md](https://github.com/usekaneo/kaneo/blob/main/README.md) |
Project overview, quick-start guide, and community links |
[CONTRIBUTING.md](https://github.com/usekaneo/kaneo/blob/main/CONTRIBUTING.md) |
Guidelines for filing issues and pull requests |
[ENVIRONMENT_SETUP.md](https://github.com/usekaneo/kaneo/blob/main/ENVIRONMENT_SETUP.md) |
Detailed setup and CORS troubleshooting |
[CLAUDE.md](https://github.com/usekaneo/kaneo/blob/main/CLAUDE.md) |
Monorepo architecture (API, web, docs structure) |
[charts/kaneo/README.md](https://github.com/usekaneo/kaneo/blob/main/charts/kaneo/README.md) |
Helm chart instructions for Kubernetes deployments |
Real-Time Community Support via Discord
For immediate assistance, join the Kaneo Discord server at https://discord.gg/rU4tSyhXXU. This invite link is located at line 12 of the README.
What you'll find in the Discord community:
- Real-time chat with the core development team
- Quick answers from experienced users
- Community-driven tips for self-hosted deployments
- Announcements about new releases and features
Discord is particularly valuable for self-hosted users who need environment-specific troubleshooting that may not be covered in generic documentation.
Structured Issue Tracking on GitHub
When you encounter reproducible bugs or have feature requests, use GitHub's structured workflows.
GitHub Issues
Open a new issue at https://github.com/usekaneo/kaneo/issues — this link appears at line 54 of the README.
Issues are tracked, searchable, and linked to code changes. Use this channel for:
- Bug reports with reproduction steps
- Feature requests with clear use cases
- Performance problems with metrics
GitHub Discussions
For open-ended questions and ideas that don't fit the issue workflow, use the Discussions tab at https://github.com/usekaneo/kaneo/discussions. This is ideal for:
- Architecture questions
- Community polls
- Sharing custom configurations
Programmatic Support via Model Context Protocol (MCP)
Kaneo uniquely provides built-in AI-assisted support through its MCP endpoint at /api/mcp. This enables programmatic interaction with your instance for automation and diagnostics.
Using the Official MCP Client
Install and use the @kaneo/mcp package to interact with your Kaneo instance programmatically:
// Install the client: npm install -g @kaneo/mcp
import { createMCPClient } from "@kaneo/mcp";
const client = createMCPClient({
baseUrl: process.env.KANEO_API_URL ?? "http://localhost:1337",
apiKey: process.env.KANEO_API_KEY, // optional for non-interactive auth
});
async function listTasks() {
const tasks = await client.tasks.list();
console.log("Tasks:", tasks);
}
listTasks().catch(console.error);
The client automatically connects to the /api/mcp endpoint, providing programmatic access to tasks, projects, and labels. This can be leveraged for:
- Building custom support bots
- Automated diagnostics scripts
- Integration with AI assistants (Claude, Cursor)
Details are documented in the [packages/mcp/README.md](https://github.com/usekaneo/kaneo/blob/main/packages/mcp/README.md) and MCP documentation at https://docs.kaneo.app/core/integrations/mcp.
Automated Issue Creation from the Command Line
For streamlined bug reporting, use the GitHub CLI to create issues directly from your terminal:
# Install the GitHub CLI
brew install gh # macOS
# Or: https://github.com/cli/cli for other platforms
# Authenticate
gh auth login
# Create a new issue
gh issue create \
--repo usekaneo/kaneo \
--title "Unexpected 500 error when creating a task" \
--body "Steps to reproduce:\n1. Log in\n2. Create a new task...\nEnvironment: Docker Compose, PostgreSQL 16"
This approach is especially useful for operators managing multiple self-hosted instances who want to standardize their reporting workflow.
Direct Financial Support and Sponsorship
To directly support Kaneo development and gain visibility within the community, sponsor the project on GitHub at https://github.com/sponsors/andrejsshell. This link appears at line 51 of the README.
Sponsors receive:
- Recognition on the project website
- Direct access to maintainers for critical issues
- Priority consideration for feature requests
Architectural Considerations for Self-Hosted Support
Understanding Kaneo's architecture helps you determine the right support channel:
-
Self-hosted by default: Kaneo runs as Docker containers (API, web UI, PostgreSQL) that you control. Most operational issues are environment-specific and best addressed through Discord or documentation.
-
MIT License: The permissive license allows you to fork, modify, and deploy private instances. You can create internal support channels if needed.
-
Monorepo structure: Source code is organized across
apps/api,apps/web, andpackages/directories as documented in [CLAUDE.md](https://github.com/usekaneo/kaneo/blob/main/CLAUDE.md). This structure helps you locate relevant code when debugging.
Summary
- Fastest answers: Check
https://kaneo.app/docs/coreand repository markdown files first - Real-time help: Join Discord at
https://discord.gg/rU4tSyhXXU - Bug reports: Use GitHub Issues at
https://github.com/usekaneo/kaneo/issues - Open discussion: Post in GitHub Discussions for architecture questions
- Programmatic access: Leverage the
/api/mcpendpoint with@kaneo/mcp - Kubernetes deployments: Consult
charts/kaneo/README.mdfor Helm-specific guidance - No public email: Critical issues should be tagged in GitHub Issues for maintainer attention
Frequently Asked Questions
What is the fastest way to get help with a Kaneo installation?
Check the official documentation at https://kaneo.app/docs/core first, then join the Discord server for real-time assistance. Most common setup issues are covered in [ENVIRONMENT_SETUP.md](https://github.com/usekaneo/kaneo/blob/main/ENVIRONMENT_SETUP.md), particularly CORS configuration and environment variable problems.
Does Kaneo offer paid commercial support?
There is no formal commercial support tier. The project is MIT-licensed and community-driven. However, GitHub sponsors at https://github.com/sponsors/andrejsshell receive recognition and prioritized attention for critical issues. Organizations requiring dedicated support can fork the repository and maintain private patches under the license terms.
How do I report a security vulnerability in Kaneo?
The repository does not expose a public security email to avoid spam. Open a GitHub issue and tag the maintainers directly, or use GitHub's private vulnerability reporting feature if available. For self-hosted instances, you control the infrastructure and can apply patches immediately from the source without waiting for an official release.
Can I use AI tools to help manage my Kaneo instance?
Yes. Every Kaneo instance ships with an MCP endpoint at /api/mcp. Install the @kaneo/mcp package to enable Claude, Cursor, or other MCP-compatible clients to read tasks, update projects, and automate workflows. This provides AI-assisted operational support without requiring external API integrations.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" Maintain an open-source project? Get it listed too →