finds.dev

Peppermint-Lab/peppermint

An open source issue management & help desk solution. A zendesk & jira alternative

View on GitHubHomepage ↗

★ 3,131TypeScriptNOASSERTIONupdated Sep 2025

// the take

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.

We read the README, the directory tree and a key source file in June 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
3,131
Forks
382
Language
TypeScript
License
NOASSERTION
Last commit
21 Sep 2025

// nearby

If peppermint isn't quite it.

All repos →