Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Peppermint-Lab/peppermint

An open source issue management & help desk solution. A zendesk/freshdesk alternative
https://github.com/Peppermint-Lab/peppermint

crm customer-relationship-management docker full-stack helpdesk issue-tracker javascript knowledge-base nextjs nodejs notebook peppermint prisma react self-hosted ticket-management ticketing-system zendesk zoho-crm

Last synced: 2 days ago
JSON representation

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

Awesome Lists containing this project

README

        

Welcome to Peppermint Ticket Management 🍵



Version

Github Stars:




Logo


This project is supported by:






> Ticket Management System in order to help helpdesks & service desks manage internal staff & customer requests

## ✨ Features

- **Ticket Creation**: Bog standard ticket creation with a markdown editor and file uploads
- **A log of client history**
- **Markdown based Notebook with todo lists**
- **Responsive**: Designed for variable screen sizes from mobile up to 4k
- **Multi-deployment**: Quickly deploy using docker & pm2
- **Simple to Use**: Designed to be easy to use with a simple logical workflow

## 🐳 Installation with docker

Check out the getting started guide if this is the first time you've used Peppermint:

```
version: "3.1"

services:
peppermint_postgres:
container_name: peppermint_postgres
image: postgres:latest
restart: always
ports:
- 5432:5432
volumes:
- pgdata:/var/lib/postgresql/data
environment:
POSTGRES_USER: peppermint
POSTGRES_PASSWORD: 1234
POSTGRES_DB: peppermint

peppermint:
container_name: peppermint
image: pepperlabs/peppermint:latest
ports:
- 3000:3000
- 5003:5003
restart: always
depends_on:
- peppermint_postgres
environment:
DB_USERNAME: "peppermint"
DB_PASSWORD: "1234"
DB_HOST: "peppermint_postgres"
SECRET: 'peppermint4life'

volumes:
pgdata:

```

Once this is completed then you can go to your server-ip:3000 which was added to the compose file and login.

The default login credentials are

```
[email protected]
1234
```

## One click installers

- We are now on linode marketplace we can be viewed here here
- We have a one line installer for Ubuntu and Debian (for the moment) and can be viewed here here

## Documentation

We have started working on creating documentation for peppermint which covers development to general usage. Click here to be taken directly there.

## Motivation

- This was initially a project to tie together my react and nodeJS skills and show something for my portfolio
- It looked terrible! But it worked and showed functionaility, which got me a job.
- Learn and deploy with docker
- Redo the UI, completly from the ground up. Which has now been completed and for me looks great.
- Build on this foundation and create a fully fledged product which offers what the big boys offer, but, at a much better ROI than signing up for zendesk etc.

Give a ⭐️ if this project helped you!

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=Peppermint-Lab/peppermint&type=Date)](https://star-history.com/#Peppermint-Lab/peppermint&Date)

## Activity
![Alt](https://repobeats.axiom.co/api/embed/9b568eb9e41b60f60fe155836b1ef0fb2a7b93b9.svg "Repobeats analytics image")

- Website: [peppermint.sh](https://peppermint.sh/)
- Github: [@potts99](https://github.com/potts99)
- LinkedIn: [@jack-andrews-146852131](https://linkedin.com/in/jack-andrews-146852131)