How to Install ERPNext on macOS

ERPNext is an open-source business management tool that helps organizations manage a wide range of activities like accounting, inventory, sales, HR, and more. In this tutorial, we will guide you through the steps to install ERPNext on macOS.

Prerequisites

Before proceeding with the installation, make sure your system meets the following requirements:

  • macOS version 10.13 or higher
  • Python version 3.6 or higher
  • Node.js version 10 or higher
  • PostgreSQL version 10 or higher
  • Redis version 4 or higher

Step 1: Install Homebrew

Homebrew is a package manager for macOS that makes it easy to install and manage software packages on your system. To install Homebrew, open the Terminal app and enter the following command:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

This command will download and install Homebrew on your system.

Step 2: Install Prerequisites

After installing Homebrew, you can use it to install the prerequisites for ERPNext. Enter the following commands in the Terminal app:

$ brew install python
$ brew install node
$ brew install postgresql
$ brew install redis

These commands will install Python, Node.js, PostgreSQL, and Redis on your system.

Step 3: Create a User Account

Next, you need to create a new user account on your system. This account will be used to run ERPNext. Enter the following command in the Terminal app:

$ sudo dscl . -create /Users/frappe

This command will create a new user account named "frappe". You can replace "frappe" with a different username if you prefer.

Step 4: Install ERPNext

To install ERPNext, you need to download the installer script from the ERPNext website. Open a web browser and go to https://erpnext.com/download. Click on the "Download for Mac" button to download the installer script.

After downloading the script, open the Terminal app and navigate to the location where the script is saved. Use the following command to navigate to the Downloads folder:

$ cd ~/Downloads

Next, make the script executable using the following command:

$ chmod +x install.py

Finally, run the script using the following command:

$ sudo python3 install.py --production --user frappe

This command will install ERPNext on your system and configure it for production use. You can replace "frappe" with the username you created in Step 3.

Step 5: Access ERPNext

After installing ERPNext, you can access it using a web browser. Open a web browser and go to http://localhost:8080. This will open the ERPNext login page.

Enter the username and password you specified during installation to log in to ERPNext. You can now start using ERPNext to manage your business activities.

Conclusion

In this tutorial, we showed you how to install ERPNext on macOS. By following these steps, you can install and configure ERPNext on your system and start using it to manage your business activities.