[Tutorial] ERPNext-15 Setup | Docker

ERPNext
1

Summary

This tutorial contains the Development Setup in Docker.
Note: its not for Production only for Development.

Get Started

Step 1

Clone the frappe_docker

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

cd frappe_docker

Step 2

Copy example devcontainer config from devcontainer-example to .devcontainer

cp -R devcontainer-example .devcontainer

Step 3

Copy example vscode config for devcontainer from development/vscode-example to development/.vscode . This will setup basic configuration for debugging.

cp -R development/vscode-example development/.vscode

Step 4

  • Install Remote - Containers for VSCode
code --install-extension ms-vscode-remote.remote-containers

Step 5

Open the frappe_docker folder in your VS-Code

code .
  • Launch the command, from Command Palette (Ctrl + Shift + P) Remote-Containers: Reopen in Container. You can also click in the bottom left corner to access the remote container menu.

Step 6

nvm use v18

PYENV_VERSION=3.10.13 bench init --skip-redis-config-generation --frappe-branch version-15 frappe-bench

cd frappe-bench

If your Facing any issue related yarn run this command

install yarn

Step 7

bench set-config -g db_host mariadb
bench set-config -g redis_cache redis://redis-cache:6379
bench set-config -g redis_queue redis://redis-queue:6379
bench set-config -g redis_socketio redis://redis-queue:6379

Step 8

bench new-site --mariadb-root-password 123 --admin-password admin --no-mariadb-socket mysite.localhost

bench use mysite.localhost

Step 9

bench --site set-config developer_mode 1

bench --site clear-cache

Step 10 - ERPNex

bench get-app --branch version-15 erpnext

bench --site install-app erpnext

Step 11 - HRMS

bench get-app --branch version-15 hrms

bench --site install-app hrms

Step 12 - Payments

bench get-app --branch version-15 https://github.com/frappe/payments.git

bench --site install-app payments

Step 13 - India Compliance

bench get-app --branch version-15 https://github.com/resilient-tech/india-compliance.git

bench --site install-app india_compliance

Step 14

bench build

bench migrate

Step 15

bench start

That’s it you can start create your Custom App and Develop and customize the ERPNext

Contact

Github : Antony-M1 · GitHub
Linkedin : Antony

7 Likes
2

Good Work @Antony_Praveenkumar. Keep it up.

1 Like
3

What about the next tutorial, how to deploy in a production environment? So that’s it?

4

please mention your requirement clearly @taitai

If you want production setup for version-15 in docker please refer this

1 Like
5

Hey
Can anyone please help me set up Frappe with Docker without ERPNext?

I’m trying to build a custom app (e.g., simple product management CRUD). I followed the frappe_docker GitHub instructions, created a new site, app, and installed the app — but ERPNext still loads by default.

I also updated the hosts file with the site name, but when I visit sitename:8080, I still see ERPNext instead of my custom app.

If anyone has done this or can guide me, I’d really appreciate it :pray:

6

You are trying to develop in a production container.

Lucky you, I have recently finished preparing a script to spin up a Frappe development container in few clicks, check it out;

You can also use it to create a development instance on Github Codespaces.

Once you finished developing your app, follow this guide to build a custom image (without ERPNext and with your new custom app) so you can setup a production container.

7

This is really helpfull, Thanks for the guide.

Can you please help with the workflow on how to setup to frappe with erpnext, hrms, indian compliance. with continuous development and managing git repo.

1 Like