How To: Set up an erpnext docker dev environment. [Linux All Commands]

Setting up a dev environment

  1. Create dirs
  • sudo mkdir -p /opt/shared/frappe
  • cd /opt/shared
  1. Create frappe user and add to docker group, do not skip this.
  • sudo useradd frappe
  • sudo usermod -aG docker frappe
  • sudo chown -R frappe:frappe frappe
  1. Change into the user and download containers
  • sudo su frappe
  • cd frappe
  • git clone https://github.com/frappe/frappe_docker.git
  • cd frappe_docker
  • cp -R devcontainer-example .devcontainer
  1. Start Docker Daemon and go!
  • sudo systemctl start docker (from different terminal, frappe isn’t in sudoers list)
  • docker-compose -f .devcontainer/docker-compose.yml up -d (from frappe user it is in docker group as we added it)
  • docker exec -e "TERM=xterm-256color" -w /workspace/development -it devcontainer-frappe-1 bash
    You are now in the container and can run bench commands
  1. Install ERPNext + Frappe
  • sudo chown -R frappe:frappe /workspace
  • python installer.py -n 20 -d mariadb
  • cd frappe-bench
  • bench use development.localhost
  • bench start

Congratulations you are now running an ERPNEXT development instance. Do the
install on 127.0.0.1:8000/app and create a company

1 Like