Peppermint

一个票务管理系统,其目标是拥有一个漂亮的 UI,易于使用的特性,轻量级的基础设施,并能够在任何你想要的硬件上运行。「A ticket management system which aims to have a nice UI with easy to use features, lightweight infrastructure & the ability to run on any hardware you want 🍵」

Github stars Tracking Chart

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

Installation

Currently only linux has been verified as working but we are open to the idea of supporting windows eventually as well.

Keep in mind, this is an alpha so the risk of data loss is real and it may not be stable, we do not recommend anyone runs this in a production enviroment.

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

version: "3.1"

services:
  postgres:
    container_name: postgres
    image: postgres:latest
    restart: always
    volumes:
      - ./docker-data/db:/data/db
    environment: 
      POSTGRES_USER: peppermint
      POSTGRES_PASSWORD: 1234
      POSTGRES_DB: peppermint

  client:
    container_name: peppermint
    image: pepperlabs/peppermint
    ports:
      - 5000:5000
    restart: on-failure
    depends_on:
      - postgres
    environment:
      PORT: 5000
      DB_USERNAME: "peppermint"
      DB_PASSWORD: "1234"
      DB_HOST: "postgres"
      BASE_URL: "http://localhost"

🤝 Contributing

Contributions, issues and feature requests are welcome!Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!

Setting up postgres on Macos in a container for local development

docker run --rm -P -p 127.0.0.1:5432:5432 -e POSTGRES_PASSWORD="1234" --name pg postgres:alpine

One click installers

  • We are now on linode marketplace we can be viewed here here

Supported Environment Variables

You can utilize the following environment variables in Peppermint. None of them are manditory.

Variable Description
PUID Set userid that the container will run as.
PGID Set groupid that the container will run as.
DB_USERNAME Enter database username here
DB_PASSWORD Enter database password here
PORT Choose a custom port to run the app on rather than the default 5000

✨ Features

  • 💡 Job Logging
  • 📜 Client History
  • 💎 Notes creation & Todo List
  • 📐 Admin Page: Admin Dashboard for easy webUI changes and analytics
  • 📱 Responsive: Designed for variable screen sizes from mobile up to 4k
  • ⚙️ Docker-Ready: Quickly deploy using docker
  • Usage: No barriers to use with complete documentation on how to complete tasks

Roadmap for new features

There is currently a trello roadmap available which is updated daily - https://trello.com/b/tOMsptar/peppermint

Documentation

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

Installing locally for development

If you're interested in developing for Peppermint, wether that be a bug fix or locally we have a guide on our wiki

Author

👤 Jack Andrews

Overview

Name With OwnerPeppermint-Lab/peppermint
Primary LanguageTypeScript
Program languageJavaScript (Language Count: 5)
PlatformDocker, Linux, Mac, Windows
License:Other
Release Count26
Last Release Name0.4.6 (Posted on )
First Release Name0.1 (Posted on )
Created At2020-11-05 21:56:53
Pushed At2024-04-19 00:55:26
Last Commit At2024-04-11 00:04:47
Stargazers Count1.6k
Watchers Count25
Fork Count160
Commits Count1.4k
Has Issues Enabled
Issues Count173
Issue Open Count43
Pull Requests Count103
Pull Requests Open Count1
Pull Requests Close Count15
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private
To the top