# Peppermint

Peppermint is a self-hosted help desk for support teams to track, prioritise, and resolve customer tickets in one central place. It is open source and self-hosted, installable on ZimaOS.

Canonical page: https://ourlocalhost.com/app/3930/peppermint

## Description

Peppermint is a self-hosted help desk for support teams to track, prioritise, and resolve customer tickets in one central place.

## Platform availability

Available on 1 of 10 platforms: ZimaOS.

## Health score

25/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (GitHub repository no longer exists)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 80 (1 GB minimum RAM, runs on ARM)

## Links

- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/peppermint

## Common questions

### What database credentials do I need to set when running Peppermint with Docker?

Set POSTGRES_PASSWORD and DB_PASSWORD to the same strong password in docker-compose.yml. POSTGRES_PASSWORD is the database password, while DB_PASSWORD is the password Peppermint uses to reach the database.

### Why should I change the SECRET value in the Docker setup?

Change SECRET to a long random value before starting Peppermint. Leaving it at the default can allow someone to access the database or fake logins.

### What data should I back up for Peppermint?

Back up the pgdata Docker volume, which the example compose file uses to store the database. If that volume is missing or corrupted, Peppermint can lose its records or fail to work properly.

### Should I expose Peppermint directly by a domain name?

If you plan to access Peppermint by a domain name, put a reverse proxy in front of it and use HTTPS. This prevents direct access to the app’s ports and helps protect logins from eavesdropping.

---
Source: Our Local Host (https://ourlocalhost.com/app/3930/peppermint), the self-hosted and open-source app directory.
