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

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