└── README.md /README.md: -------------------------------------------------------------------------------- 1 | # Guide-to-Install-Frappe-ERPNext-in-Windows-11-Using-Docker 2 | 3 | A complete Guide to Install Frappe Bench in Windows 11 Using Docker and install Frappe/ERPNext Application 4 | 5 | ### Pre-requisites 6 | 7 | Docker Desktop 8 | git 9 | Wnidows 11 10 | VS Code 11 | 12 | 13 | ### STEP 1 Check Docker version 14 | docker version 15 | git version 16 | 17 | ### STEP 2 Clone frappe_docker and move to frappe_docker folder 18 | 19 | git clone https://github.com/frappe/frappe_docker.git 20 | cd frappe_docker 21 | 22 | ### STEP 3 23 | 24 | Copy example devcontainer config from 25 | 26 | devcontainer-example folder to .devcontainer folder 27 | 28 | Copy example vscode config for devcontainer from 29 | 30 | development/vscode-example folder to development/.vscode folder 31 | 32 | ### STEP 4 Install VSCode Remote Containers extension 33 | 34 | Open vscode and install 'Dev Containers' extension 35 | 36 | ### STEP 5 After the extensions are installed, you can 37 | 38 | Open frappe_docker folder in VS Code. 39 | 40 | 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. 41 | 42 | ### Note: 43 | if this error in running contaners try the below commnad in CMD 44 | 45 | Error starting userland proxy: listen tcp 0.0.0.0:80: bind: An attempt was made to access a socket in a way forbidden by its access permissions 46 | 47 | netsh http add iplisten ipaddress=:: 48 | 49 | The development directory is ignored by git. It is mounted and available inside the container. Create all your benches (installations of bench, the tool that manages frappe) inside this directory. 50 | Node v14 and v10 are installed. Check with nvm ls. Node v14 is used by default. 51 | 52 | 53 | ### STEP 6 Initilase frappe bench with frappe version 14 and Switch directory 54 | 55 | 56 | bench init --skip-redis-config-generation --frappe-branch version-14 frappe-bench 57 | cd frappe-bench 58 | 59 | 60 | ### STEP 7 Setup hosts 61 | 62 | We need to tell bench to use the right containers instead of localhost. Run the following commands inside the container: 63 | 64 | bench set-config -g db_host mariadb 65 | bench set-config -g redis_cache redis://redis-cache:6379 66 | bench set-config -g redis_queue redis://redis-queue:6379 67 | bench set-config -g redis_socketio redis://redis-socketio:6379 68 | For any reason the above commands fail, set the values in common_site_config.json manually. 69 | 70 | { 71 | "db_host": "mariadb", 72 | "redis_cache": "redis://redis-cache:6379", 73 | "redis_queue": "redis://redis-queue:6379", 74 | "redis_socketio": "redis://redis-socketio:6379" 75 | } 76 | 77 | ### STEP 8 Create a new site 78 | sitename MUST end with .localhost for trying deployments locally. 79 | MariaDB root password: 123 80 | 81 | bench new-site d-code.localhost --no-mariadb-socket 82 | 83 | 84 | ### STEP 9 Set bench developer mode on the new site 85 | 86 | bench --site d-code.localhost set-config developer_mode 1 87 | bench --site d-code.localhost clear-cache 88 | 89 | 90 | ### STEP 10 Install ERPNext 91 | 92 | bench get-app --branch version-14 --resolve-deps erpnext 93 | bench --site d-code.localhost install-app erpnext 94 | 95 | 96 | 97 | 98 | ### STEP 11 Start Frappe bench 99 | 100 | bench start 101 | 102 | You can now login with user Administrator and the password you choose when creating the site. Your website will now be accessible at location d-code.localhost:8000 103 | 104 | 105 | --------------------------------------------------------------------------------