Docs
Introduction
Introduction
Welcome to the GudDesk documentation. Learn how to set up and use your open-source customer messaging platform.
Welcome to GudDesk, the open-source customer messaging platform built for the agent era.
GudDesk gives you live chat, a shared inbox, a knowledge base, an agent API and SLA policies in a single self-hostable platform licensed under AGPL-3.0.
What You Can Do
- Talk to customers with an embeddable chat widget. Replies show up in the open widget within seconds
- Manage all conversations from a unified shared inbox (chat, email, bots)
- Connect your own AI agent through the API so it can reply as BOT
- Build a knowledge base so customers can help themselves
- Set SLA policies with first-response and resolution deadlines. Automation rules are planned and not available yet
- Extend GudDesk with the REST API and webhooks. AI assistants can connect through the MCP server
Quick Links
Quickstart
Use GudDesk Cloud or run it locally
Self-HostingDeploy on your own infrastructure
Chat WidgetAdd live chat to your site
AI AgentsConnect your own bot through the agent API
Tech Stack
GudDesk is built with modern, battle-tested technologies:
- Next.js: React framework for the dashboard and marketing site
- PostgreSQL: Primary database (via Prisma ORM)
- Auth.js: Authentication with Google OAuth and magic links
- Resend: Transactional email delivery
- Pusher: real-time messaging for live chat. GudDesk Cloud uses it. Without Pusher keys, the widget polls for replies every 4 seconds
- Tailwind CSS: Utility-first styling
- Shadcn/ui: Accessible component library
Getting Help
- GitHub Issues: Report bugs or request features
- Discussions: Ask questions and share ideas
- Email: support@guddesk.com