// the find
Peppermint-Lab/peppermint
An open source issue management & help desk solution. A zendesk & jira alternative
Peppermint is a self-hosted help desk and ticket management system built on Next.js and a Node/Express API, backed by Postgres via Prisma. It targets small teams that want a Zendesk/Jira replacement they can run themselves without the per-seat pricing. Docker Compose deployment is the primary path.
IMAP ingestion with OAuth support means email-to-ticket works without storing plaintext passwords. RBAC with custom roles (50+ migrations showing real iteration) suggests it has been hardened by actual usage rather than being purely demo-ware. OIDC/SAML/OAuth SSO support is genuinely useful for small orgs that don't want password management. i18n coverage across 16 languages, including RTL (Hebrew), is rare for a project at this star count.
The default docker-compose ships with `SECRET: 'peppermint4life'` hardcoded — that's a foot-gun that will bite anyone who copies it without reading. Still on version 0.2 badge despite a migration history spanning 2023–2024, which tells you the versioning is not kept up to date and you can't trust the badge for anything. The API and client are two separate apps with no shared type generation (no tRPC, no OpenAPI codegen), so API/client drift is a maintenance risk. No test directory visible anywhere in the tree — adopting this means you're trusting CI to catch regressions that aren't tested.