Crisp
Customer messaging platform with live chat, shared inbox, knowledge base, and AI chatbot
Peppermint
Self-hosted ticketing system with markdown notes and Docker deployment
A responsive, self-hosted help-desk platform offering markdown-based ticket creation, file uploads, client history, and easy Docker or one-click deployment for teams of any size.
Overview
Overview
Peppermint is a responsive ticket management solution designed for help desks and service teams. It provides a markdown editor for ticket creation, supports file uploads, and maintains a searchable log of client interactions. Integrated notebook features let users add todo lists and knowledge‑base entries, keeping troubleshooting steps close at hand.
Deployment & Workflow
The application can be launched quickly with a Docker‑Compose file or managed via PM2, and a one‑click installer is available on the Linode Marketplace for Ubuntu/Debian. Its simple, logical workflow reduces onboarding time, while the UI scales from mobile devices to 4K screens, ensuring a consistent experience across environments.
Audience
Ideal for small to medium organizations that prefer on‑premise control over support data and want a cost‑effective alternative to commercial platforms like Zendesk or Jira.
Highlights
Markdown editor with file attachments for tickets
Integrated client history notebook with todo lists
Responsive UI scaling from mobile to 4K displays
One‑click Docker/PM2 deployment and Linode marketplace installer
Pros
- Self‑hosted gives full data control
- Simple logical workflow reduces training effort
- Responsive design works on any device
- Docker Compose makes setup reproducible
Considerations
- Requires own server resources and maintenance
- Limited out‑of‑the‑box integrations compared to SaaS options
- Documentation is still maturing
- Advanced reporting features are not included
Managed products teams compare with
When teams consider Peppermint, these hosted platforms usually appear on the same shortlist.
Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.
Fit guide
Great for
- Small to medium teams needing a cost‑effective ticketing solution
- Organizations that prefer on‑premise data privacy
- Developers comfortable with Docker deployments
- Companies looking to replace Zendesk/Jira with a self‑hosted alternative
Not ideal when
- Large enterprises requiring extensive enterprise‑grade analytics
- Teams without technical staff to manage server upkeep
- Businesses needing a deep third‑party app ecosystem
- Users seeking a fully managed cloud service
How teams use it
Internal IT support desk
Track employee requests, attach screenshots, and maintain a searchable history of issues.
Customer service ticketing for SaaS startup
Provide clients a portal to submit tickets, manage communications, and resolve issues without external subscription fees.
Project knowledge base
Use the markdown notebook to document troubleshooting steps and assign todo items across the team.
On-premise help desk for regulated industry
Keep all support data behind the firewall, meeting compliance requirements while using a responsive UI.
Tech snapshot
TypeScript88%
JavaScript11%
CSS2%
Dockerfile1%
Frequently asked questions
Can I run Peppermint without Docker?
Yes, you can run it with Node.js and PM2, but Docker is the recommended and simplest deployment method.
Is there a subscription fee?
No, Peppermint is self‑hosted and free to use; you only cover your own infrastructure costs.
What database does Peppermint use?
It uses PostgreSQL, as defined in the Docker‑Compose configuration.
How can I back up my data?
Back up the PostgreSQL volume (pgdata) regularly; standard PostgreSQL backup procedures apply.
Project at a glance
Stable- Stars
- 2,896
- Watchers
- 2,896
- Forks
- 330
Repo age5 years old
Last commit4 months ago
Self-hostingSupported
Primary languageTypeScript
Last synced 3 hours ago