bench get-app https://github.com/robisurasko/helpdesk

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=robisurasko%2Fhelpdesk)](https://frappegems.com/gems/apps/robisurasko/helpdesk)

## Frappe Helpdesk Helpdesk is an 100% open-source Ticket Management tool which helps you streamline your company's support, offers an easy setup, clean user interface, and automation tools to resolve customer queries efficiently. ### Motivation Managing issues from our customers was a big challenge for us. We were using the ERPNext support module which was not very good in UI and the UX was also not good. We wanted to have a tool that can be easily integrated with our existing system and can be customized as per our needs. So we decided to build Frappe Helpdesk. ### Key Features - **Agent and Customer Portal Views**: Dual portals for agents and customers to simplify issue submission and management. - **Customizable SLAs**: Discover how you can set and track SLAs for better response times. - **Assignment Rules**: Custom auto-assignment of tickets based on priority, issue type, or workload. - **Knowledge Base**: Learn how to create and manage help articles to empower users and reduce tickets. - **Canned Responses**: Pre-written replies for common queries to ensure quick and consistent communication.

### Under the Hood - [**Frappe Framework**](https://github.com/frappe/frappe): A full-stack web application framework written in Python and Javascript. - [**Frappe UI**](https://github.com/frappe/frappe-ui): A Vue-based UI library, to provide a modern user interface. ## Production Setup ### Managed Hosting You can try [our cloud](https://superapp.rndsolusi.com/helpdesk/signup), a simple and user-friendly It takes care of installation, setup, upgrades, monitoring, maintenance and support of your Frappe deployments. It is a fully featured developer platform with an ability to manage and control multiple Frappe deployments. ### Self Hosting Follow these steps to set up Frappe Helpdesk in production: **Step 1**: Download the easy install script ```bash wget https://frappe.io/easy-install.py ``` **Step 2**: Run the deployment command ```bash python3 ./easy-install.py deploy \ --project=helpdesk_prod_setup \ --email=your_email.example.com \ --image=ghcr.io/frappe/helpdesk \ --version=stable \ --app=helpdesk \ --sitename subdomain.domain.tld ``` Replace the following parameters with your values: - `your_email.example.com`: Your email address - `subdomain.domain.tld`: Your domain name where Helpdesk will be hosted The script will set up a production-ready instance of Frappe Helpdesk with all the necessary configurations in about 5 minutes. ## Development Setup ### Docker You need Docker, docker-compose and git setup on your machine. Refer [Docker documentation](https://docs.docker.com/). After that, follow below steps: **Step 1**: Setup folder and download the required files mkdir frappe-helpdesk cd frappe-helpdesk # Download the docker-compose file wget -O docker-compose.yml https://raw.githubusercontent.com/frappe/helpdesk/develop/docker/docker-compose.yml # Download the setup script wget -O init.sh https://raw.githubusercontent.com/frappe/helpdesk/develop/docker/init.sh **Step 2**: Run the container and daemonize it docker compose up -d **Step 3**: The site [http://helpdesk.localhost:8000/helpdesk](http://helpdesk.localhost:8000/helpdesk) should now be available. The default credentials are: - Username: Administrator - Password: admin ### Local To setup the repository locally follow the steps mentioned below: 1. Install bench and setup a `frappe-bench` directory by following the [Installation Steps](https://frappeframework.com/docs/user/en/installation) 1. Start the server by running `bench start` 1. In a separate terminal window, create a new site by running `bench new-site helpdesk.test` 1. Map your site to localhost with the command `bench --site helpdesk.test add-to-hosts` 1. Get the Helpdesk app. Run `bench get-app https://github.com/frappe/helpdesk` or `bench get-app --branch main helpdesk https://github.com/robisurasko/helpdesk.git` 1. Run `bench --site helpdesk.test install-app helpdesk`. 1. Now open the URL `http://helpdesk.test:8000/helpdesk` in your browser, you should see the app running **For Frontend Development** 1. Open a new terminal session and cd into `frappe-bench/apps/helpdesk/desk`, and run the following commands: ``` yarn install yarn dev or yarn dev --host helpdesk.test ``` 1. Now, you can access the site on vite dev server at `http://helpdesk.test:8080` **Note:** You'll find all the code related to Helpdesk's frontend inside `frappe-bench/apps/helpdesk/desk` ## Learn and connect - [Telegram contact me ](https://t.me/robisurasko)