ERPNext Conference 2019* Blog

[Tutorial] How To install ERPNext V12 on windows 10 home / Pro WSL ubuntu 18.04LTS


ERPNext V12, Frappe 12 or later
Applies to windows home 10 build 18362 or higher, windows Pro, WSL ubuntu 18.04 LTS

Install ERPNext V12 on windows home 10 WSL ubuntu 18.04 LTS.

1- check your windwos 10 build number, should be >= 18362
win +R, cmd, ver

2 - install ubuntu 18.04 LTS WSL on windows10, follow steps under this page

2- execute below command using your unix user (in my case I have created nofal user)

  • nofal@LAPTOP-5F23F7J8:~$ sudo apt-get update
  • nofal@LAPTOP-5F23F7J8:~$ sudo apt-get upgrade
  • frappe@LAPTOP-5F23F7J8:~/frappe-bench$ lsb_release -a – should get like below result
    No LSB modules are available.
    Distributor ID: Ubuntu
    Description: Ubuntu 18.04.3 LTS
    Release: 18.04
    Codename: bionic
  • Reboot WSL
    Just open a cmd window as adminstrator and run these commands to restart it.
    net stop LxssManager
    net start LxssManager
    restart windows
    Launch ubuntu as non root user:
  • sudo mkdir -p /run/dbus
  • sudo service dbus start
  • sudo apt-get install python3-setuptools python3-minimal redis-server build-essential
  • sudo adduser frappe – can be any name mycase I have used frappe as a user
  • sudo usermod -aG sudo frappe
  • sudo su frappe
  • cd ~
  • sudo wget
  • sudo -H python3 --production --site frappe.local --user frappe

This will install the ERPNEXT.

  • cd frappe-bench
  • bench update

connect using url http://localhost

Important Info:
Windows home 10 or windows Pro 10 build 18362 or higher is important,

Note that I failed many time installing ERPNext, each time I restart from an WSL ubuntu fresh (under apps & features, select ubuntu, advanced options, reset)
After windows restart, you need to start below services manually:

frappe@LAPTOP-5F23F7J8:~/frappe-bench$ sudo service dbus start
[sudo] password for frappe:

  • Starting system message bus dbus

frappe@LAPTOP-5F23F7J8:~/frappe-bench$ sudo service supervisor start

frappe@LAPTOP-5F23F7J8:~/frappe-bench$ sudo service mysql start

  • Starting MariaDB database server mysqld [ OK ]
    frappe@LAPTOP-5F23F7J8:~/frappe-bench$ sudo service nginx start
  • Starting nginx nginx [ OK ]
    frappe@LAPTOP-5F23F7J8:~/frappe-bench$ sudo service redis-server start
    Starting redis-server: redis-server.

to check supervisor status:

frappe@LAPTOP-5F23F7J8:~/frappe-bench$ sudo supervisorctl status
frappe-bench-redis:frappe-bench-redis-cache RUNNING pid 73, uptime 4:40:13
frappe-bench-redis:frappe-bench-redis-queue RUNNING pid 72, uptime 4:40:13
frappe-bench-redis:frappe-bench-redis-socketio RUNNING pid 74, uptime 4:40:13
frappe-bench-web:frappe-bench-frappe-web RUNNING pid 2984, uptime 2:00:18
frappe-bench-web:frappe-bench-node-socketio RUNNING pid 2986, uptime 2:00:18
frappe-bench-workers:frappe-bench-frappe-default-worker-0 RUNNING pid 2961, uptime 2:00:19
frappe-bench-workers:frappe-bench-frappe-long-worker-0 RUNNING pid 2962, uptime 2:00:19
frappe-bench-workers:frappe-bench-frappe-schedule RUNNING pid 2960, uptime 2:00:19
frappe-bench-workers:frappe-bench-frappe-short-worker-0 RUNNING pid 2963, uptime 2:00:19

to check all service status:

frappe@LAPTOP-5F23F7J8:~/frappe-bench$ service --status-all

[-] means not started
[+] means started

to start specific service as root or not:

frappe@LAPTOP-5F23F7J8:~/frappe-bench$ sudo service nginx start

to check

frappe@LAPTOP-5F23F7J8:~/frappe-bench$ sudo service nginx status

  • nginx is running


ERPNext On Windows 10 :

How to run Linux binaries natively in Windows 10:

windows 10, WSL, ubuntu 18.04LTS, ERPNext V12

ERP Next installation error in Windows 10 Pro
ERPNext On Windows 10

my os ver


I am afraid that your os is not supported, try upgrade?


ok i m trying to update my os thanks for your support nmani


can we install it on windows 10 Enterprise version?


Yes it should work, most important thing is the windows build, check yours, read first part of my tutorial


I’ve same build number but Enterprise version, I’m unable to install it, could you please help me to get it done?


It’s tough but doable, follow steps and update me, please open new thread for your issues faced.


I’ve posted a new topic please check out here