madmath03/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/britlog/erpnext_france⁠
• https://github.com/DOKOS-IO/mautic⁠

Possible additional apps:

• https://github.com/vishdha/transport_management_system⁠ (removed due to vishdha/transport_management_system#5⁠)
• https://github.com/Monogramm/ERPNext-OCR⁠
• https://github.com/Monogramm/erpnext_autoinstall⁠

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

:construction: This image is still in development!

⁠What is ERPNext ?

Open Source ERP built for the web.

⁠Supported tags

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

• ERPNext develop branch
  • develop-alpine develop
  • develop-debian
  • develop-debian-slim
• ERPNext 12.0
  • 12-alpine 12 alpine latest
  • 12-debian debian
  • 12-debian-slim debian-slim
• ERPNext 11
  • 11-alpine 11
  • 11-debian debian
  • 11-debian-slim debian-slim
• ERPNext 10 (branch 10.x.x for latest bug fixes)
  • 10-alpine 10
  • 10-debian
  • 10-debian-slim

⁠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.

⁠References

A list of a few issues encountered during the development of this container for future reference:

• ERPNext installs fails with Postgresql due to missing column
  • Solution: none so far...
  • References:
    • https://github.com/frappe/erpnext/issues/18028⁠