ERPNext Logo

how to install erpnext on ubuntu

This guide is based on, and is tested a couple of times against ubuntu 14.04/64.

      • Login as root with ssh.
      • Optionally:
        apt-get update
        apt-get upgrade
        dpkg-reconfigure tzdata
        apt-get install nano
      • Add a user (erpnext for our example).
adduser erpnext

Store password in a safe place for later use.

      • visudo (to grant erpnext user sudo privileges, by copying root record)

A nice article on user management:

  • Login as erpnext.
    su erpnext
  • Download script at home dir and execute it.
cd ~
sudo python --production --user erpnext

You will prompted for mysql and admin passwords.
Store both passwords in a safe place for later use.

The script is going to take some moments to complete depending on hardware, let’s say 5 or 10 minutes.

  • Restart web server, sudo service nginx restart.
  • Fire up your browser and point to your server’s IP (or hostname). If everything goes well you will see eprnext login screen. Use your stored admin pass to access web app. Eventually a nice setup wizard will show up at your browser.

You’re amost done. To increase security you should install ssl. We’ll use let’s encrypt for our example.

    • su erpnext
    • cd ~
    • cd frappe-bench
    • Important! Assuming your domain is mv sites/site1.local sites/
    • nano sites/
    • Add "host_name": "",

Don’t forget commas separating json records.

  • Enable dns multitenancy: bench config dns_multitenant on
  • Regenerate nginx config: bench setup nginx
  • Reload nginx: sudo service nginx reload
  • Configure let’s encrypt: sudo -H bench setup lets-encrypt

If errors occur, recheck all your steps. If https/ssl still fails, try the manual method below.

  • su root
  • cd /opt
  • wget
  • sudo service nginx stop
  • ./opt/certbot-auto certonly --standalone
  • su erpnext
  • cd ~/frappe-bench/sites/
  • nano sites/
  • Add two lines, beware of the commas separating json records! "ssl_certificate": "/etc/letsencrypt/live/",
    "ssl_certificate_key": "/etc/letsencrypt/live/"
    , save and exit nano
  • bench setup nginx, to regenerate cofig files.
  • sudo service nginx restart

Now, you should be ok with letsencrypt cert. Letsencrypt certificate expires every three months, so you’d better set up a cronjob that automatically renew certificate. It should be as easy as adding a crontab entry.

  • crontab -e
  • Add this: # renew letsencrypt certificates on 1st monday of every month and get an email if it gets executed
    MAILTO="[email protected]"
    0 0 1-7 * * [ "$(date '+\%a')" = "Mon" ] && sudo service nginx stop && /opt/certbot-auto renew && sudo service nginx start

You’re done.


Official frappe documentation provides an article for https/ssl:

If you want to install a second site on the same server see this:

how to add a second erpnext instance on ubuntu


One response to “how to install erpnext on ubuntu”

  1. […] you have followed my previous guide on installing erpnext on a fresh ubuntu instance (, we will show you how to install a second site on the same server (DNS based […]

Leave a Reply

Your email address will not be published. Required fields are marked *