monogramm/docker-erpnext-ext repository overview

⁠ERPNext Docker container extended with custom apps

Docker image for ERPNext with additionnal apps.

This image was inspired by several other containers developed by the community:

• emadshaaban92/docker-compose-erpnext⁠ / BizzoTech/docker-erpnext⁠ for the "simple" docker-compose setup
• donysukardi/docker-frappe⁠ for the alpine variant (actually the source for BizzoTech images)
• pipech/erpnext-docker-debian⁠ for the complete setup of apps and sites

Additional apps:

• https://github.com/Monogramm/erpnext_autoinstall⁠
• https://github.com/Monogramm/erpnext_ocr⁠
• https://github.com/Monogramm/recod_frappe_devtools⁠
• https://github.com/Monogramm/recod_erpnext_design⁠
• https://github.com/Monogramm/frappe_pwa⁠
• https://github.com/britlog/erpnext_france⁠
• https://github.com/DOKOS-IO/mautic⁠ (might be removed depending on dokos-io/mautic#3)

Possible additional apps:

• https://github.com/vishdha/transport_management_system⁠ (removed due to vishdha/transport_management_system#5⁠)

Check base image Monogramm/docker-erpnext⁠ and Monogramm/docker-frappe⁠ for details.

⁠What is ERPNext

Open Source ERP built for the web.

⁠Supported tags

https://hub.docker.com/r/monogramm/docker-erpnext-ext/⁠

• 13.5.0-debian 13.5-debian 13-debian (images/13/debian/Dockerfile)
• 13.5.0-debian-slim 13.5-debian-slim 13-debian-slim (images/13/debian-slim/Dockerfile)
• 13.5.0-alpine 13.5-alpine 13-alpine 13.5.0 13.5 13 (images/13/alpine/Dockerfile)
• 12.22.0-debian 12.22-debian 12-debian (images/12/debian/Dockerfile)
• 12.22.0-debian-slim 12.22-debian-slim 12-debian-slim (images/12/debian-slim/Dockerfile)
• 12.22.0-alpine 12.22-alpine 12-alpine 12.22.0 12.22 12 (images/12/alpine/Dockerfile)
• 11.1.x-debian 11.1-debian 11-debian (images/11/debian/Dockerfile)
• 11.1.x-debian-slim 11.1-debian-slim 11-debian-slim (images/11/debian-slim/Dockerfile)
• 11.1.x-alpine 11.1-alpine 11-alpine 11.1.x 11.1 11 (images/11/alpine/Dockerfile)
• develop-debian (images/develop/debian/Dockerfile)
• develop-debian-slim (images/develop/debian-slim/Dockerfile)
• develop-alpine develop (images/develop/alpine/Dockerfile)

⁠How to run this image ?

This image does not contain the database for ERPNext. You need to use either an existing database or a database container.

This image is designed to be used in a micro-service environment using docker-compose. There are basically 2 variants of the image you can choose from: alpine or debian.

This image can also be used as a template to build your own extended ERPNext image.

⁠Import private repository

This repository provides sample configuration and scripts for importing private frappe apps to ERPNext. You can import private repositories through the following methods:

• HTTPS login / password
• SSH Key

⁠HTTPS

In order to pass the login and password to git, first:

• Dockerfile-***.template: Uncomment the For private repository: SSH section

Then, you have two choices to set your login password:

1. hooks/build (RECOMMENDED): DockerHub build hook to retrieve Git Login and Password environment and pass them. You do not store the login/password in git, but simply set environment variables in DockerHub.
2. update.sh: Update the git_login and git_password to store password in Dockerfile. This is not the best practice to put password in a git repository so please be super careful with your code and make sure to keep your reposiroty private.

⁠SSH

• Dockerfile-***.template: Uncomment the For private repository: SSH section
• Add your SSH deploy in .ssh at root of directory. This is not the best practice to put SSH keys in a git repository so please be super careful with your code and make sure to keep your reposiroty private.

⁠Running this image with docker-compose

• Select the version closest to what you want in the images folder

  • In the docker-compose.yml, you can comment the build lines, uncomment the image lines and edit versions to download prebuilt docker container.

• Feel free to edit variables defined in .env as you see fit.

• Run the docker-compose with docker-compose up -d and that's it.

• Now, go to http://localhost:80⁠ to access the first run installation wizard.

⁠Questions / Issues

If you got any questions or problems using the image, please visit our Github Repository⁠ and write an issue.