Logo
Deploy Now

Stars

3150

Forks

383

Watchers

40

Developer links

Peppermint

A deliberately simple ticketing system standing in for both Zendesk and Jira: Peppermint handles internal staff requests and external customer support alike. The stack is modern full-stack TypeScript: Next.js and React over Prisma and PostgreSQL, which makes it light to run and approachable for developers extending it. Ticket creation is straightforward - a markdown editor with file uploads, assignment, status tracking, and a logical workflow that new agents grasp without a manual. Mailbox integration converts email into tickets automatically: configure SMTP/IMAP per mailbox and incoming messages become trackable tickets. Each client accumulates an interaction history, giving agents context on every past request before replying. Two touches distinguish it from bare-bones ticketing: a built-in markdown notebook with todo lists for internal documentation and knowledge sharing, and OIDC authentication so agents sign in through your existing identity provider - Keycloak, Okta, Authentik, or Azure AD. Configurable webhooks and email notifications push ticket events to third-party services. The UI is responsive from mobile to 4K, and everything works fully offline in air-gapped environments. Docker-native and scalable via Kubernetes, with an active community of 3,000+ GitHub stargazers.

Peppermint

Benefits

  • Zendesk Workflow, Zero Subscription
  • Ticketing, mailboxes, and client history without per-agent pricing.
  • Email Becomes Tickets
  • SMTP/IMAP mailboxes automatically convert incoming mail into trackable requests.
  • Context Before Every Reply
  • Per-client interaction history shows agents each customer's full request record.
  • Plugs Into Your Identity Stack
  • OIDC single sign-on connects Keycloak, Okta, Authentik, or Azure AD.

Features

  • Markdown Ticketing
  • Create, assign, and track tickets with a markdown editor and file uploads.
  • Mailbox Integration
  • Per-mailbox SMTP/IMAP fetching that turns emails into tickets.
  • Client History Log
  • Complete interaction records for every client.
  • Internal Notebook
  • Markdown notes with todo lists for team documentation.
  • Webhooks and Notifications
  • Configurable event pushes to third-party services plus email alerts.
  • Responsive and Offline-Capable
  • Mobile-to-4K UI with all core features working without internet access.