How can I add hrms in erpnext 14

abdul_al_mamun · April 5, 2023, 3:08am

How can I add hrms in erpnext 14 in docker

Donovan_Larnia · April 7, 2023, 5:27am

As I am trying to find out the best practice for this myself, I will share what I have found out so far.

I believe the correct way to do it is to create a custom docker image which includes HRMS.

That said, I haven’t done that yet, but tried to install manually.
One caveat is, that the app’s source is being installed in ~/frappe_bench/apps and this directory is part of the image and not persisted via docker volumes. Therefore the HRMS source needs to be installed in the custom docker image.

Just to get a hang of it and see how it works, I defined a docker volume for frappe-bench:/home/frappe/frappe-bench and ran the following commands from the backend image (docker container exec -it frappe_docker-backend-1 /bin/bash):
bench get-app hrms --branch version-14
bench --site frontend install-app hrms

After restarting all containers, HRMS was installed and working.

Note: This is NOT recommended at all.
The problem with this is maintenance, as it is using an overlay filesystem. Including the corresponding HRMS source to the updated erpnext docker image is crucial in order for all containers to have access to the same code and keep everything in sync.

Custom image documentation:

github.com

frappe/frappe_docker/blob/main/docs/custom-apps.md

### Clone frappe_docker and switch directory

```shell
git clone https://github.com/frappe/frappe_docker
cd frappe_docker
```

### Load custom apps through json

`apps.json` needs to be passed in as build arg environment variable.

```shell
export APPS_JSON='[
  {
    "url": "https://github.com/frappe/payments",
    "branch": "develop"
  },
  {
    "url": "https://github.com/frappe/erpnext",
    "branch": "version-14"

This file has been truncated. show original

trustedcomputer · April 7, 2023, 1:26pm

That document you quoted is the correct method. Since HRMS has been spun off into it’s own app in v14, you need to include the app in the image at time of creation. This is also true of other apps like payments, education, etc.

miljan23 · September 2, 2023, 10:32am

can someone explain how to do sa step by step

Mina-Geez · November 13, 2024, 9:00am

use the following commands:

bench get-app hrms --branch version-14
bench --site frontend install-app hrms
bench --site frontend migrate