ERPNext - a Free, Self Hosted, and Open Source ERP System

Brian McGonagill

• 2 min read

I have done a video on the method of installation for ERPNext via Docker in response to a viewer request.  The site I setup will remain up until Sept 15, 202 for anyone who wants to try it out.

I have now setup a demo administrative user for your use as well.   I hope it helps.

username: demo-admin
email: demo-admin@fixitdelrio.com
password: d3m0-admin-#@!

I found it to be quite straight forward, but did have to set some environment variables before bringing up the containers via docker-compose.

I want to say now that I am not an ERP expert by any stretch of the imagination.

If you're interested in testing out my ERPNext install, you can find it at https://erp.opensourceisawesome.com

If you can't seem to access it, email me (it's in the video) or Telegram me @MickInTx and let me know, and I'll setup an account and login credentials for you.

Timestamps

  • 00:00 Beginning
  • 00:11 Introduction to ERPNext
  • 03:55 Install ERPNext with Docker
  • 17:25 First RUN and User Interface for ERPNext
  • 20:55 Settings for ERPNext
  • 29:40 Thank you all so much!

Installation

First you need a system with Docker installed on it.  I personally use Ubuntu (or Ubuntu based OSes) on my main systems, but feel free to use whatever you are most comfortable with.

To install Docker-CE (community edition) you can follow the steps here for Ubuntu 18.04, and here for Ubuntu 20.04.

Next, you will need Docker-Compose, and git as well.  

To install these simply do these commands on a Ubuntu / Debian based system:

sudo apt update

sudo apt install docker-compose -y

sudo apt install git -y

Now you'll want to pull down the Frappe/ERPNext docker git repository from github.  

Again, in the terminal / cli, enter:

git clone https://github.com/frappe/frappe_docker.git

Now, move into the directory that was just downloaded and created.

cd frappe_docker

Before we bring up the containers, we need to set some environment variables.  Fortunately, the good folks ont eh project have created some example files for us to use as a template.

Let's copy the env-production file to a new, hidden, file name .env

cp env-production .env

Now, we need to edit the values in the .env file.

nano .env

Feel free to use emacs, vi, vim, or any other text editor, I just do nano because it's installed by default.

We need to adjust our values for the following items:

LETSENCRYPT_EMAIL= <put your email here>
ERPNEXT_VERSION=edge
FRAPPE_VERSION=edge
MARIADB_HOST=mariadb
MYSQL_ROOT_PASSWORD=<put your preferred password here>
SITE_NAME=<put your site url here>
SITES="`<put your site url here too>`" <--ignore the doublequotes ", it's important to put the back-ticks here....and I can't make them show without the double quotes.
DB_ROOT_USER=root
ADMIN_PASSWORD=<put your preferred admin password here for the site>
INSTALL_APPS=erpnext
ENTRYPOINT_LABEL=traefik.http.routers.erpnext-nginx.entrypoints=websecure
CERT_RESOLVER_LABEL=traefik.http.routers.erpnext-nginx.tls.certresolver=myresolver
HTTPS_REDIRECT_RULE_LABEL=traefik.http.routers.http-catchall.rule=hostregexp({host:.+})
HTTPS_REDIRECT_ENTRYPOINT_LABEL=traefik.http.routers.http-catchall.entrypoints=web
HTTPS_REDIRECT_MIDDLEWARE_LABEL=traefik.http.routers.http-catchall.middlewares=redirect-to-https
HTTPS_USE_REDIRECT_MIDDLEWARE_LABEL=traefik.http.middlewares.redirect-to-https.redirectscheme.scheme=https

Above. you only need to edit the values I've surrounded with <> symbols.

Once you finish making the necessary changes, save the file with CTRL+O, then Enter / Return, and CTRL + X to exit nano.

Now, you're ready to startup your ERPNext system.  Just run

docker-compose up -d

Be patient as it pulls down the various images, and starts the containers up.  It may take up to 10 minutes after all the containers are pulled down.