Prerequisite
- Install ubuntu 20.04 server
- Update Ubuntu server
- >sudo apt update
- Upgrade Ubuntu server
- >apt upgrade
Step-by-step Installation of ERPNext
STEP 1 - Install git
>sudo apt-get install git
STEP 2 install python-dev
>sudo apt-get install python3-dev
STEP 3 Install setup tools and pip (Python's Package Manager).
>sudo apt-get install python3-setuptools python3-pip
STEP 4 Install virtualenv
>sudo apt-get install virtualenv
STEP 5 Install MariaDB 10.3 stable package
>sudo apt-get install software-properties-common
>sudo apt-key adv --fetch-keys 'https://mariadb.org/mariadb_release_signing_key.asc'
>sudo add-apt-repository 'deb [arch=amd64,arm64,ppc64el] https://ftp.icm.edu.pl/pub/unix/database/mariadb/repo/10.3/ubuntu focal main'
>sudo apt update
>sudo apt install mariadb-server
STEP 6 MySQL database development files
>sudo apt-get install libmysqlclient-dev
STEP 7 Edit the mariadb configuration ( unicode character encoding )
>sudo nano /etc/mysql/my.cnf
Add this to the my.cnf file
[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
[mysql]
default-character-set = utf8mb4
Now press (Ctrl-X) to exit
Restart the MySQL service
>sudo service mysql restart
STEP 8 install Redis
>sudo apt-get install redis-server
STEP 9 install Node.js 14.X package
>sudo apt-get install curl
>curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
>sudo apt-get install -y nodejs
STEP 10 install Yarn
>sudo npm install -g yarn
STEP 11 install wkhtmltopdf
>sudo apt-get install xvfb libfontconfig wkhtmltopdf
STEP 12 install frappe-bench
>sudo pip3 install frappe-bench
IMPORTANT: you may wish to log out and log back into your terminal before next step and You must login.
>bench --version
STEP 13 initialize the frappe bench & install frappe latest version
>bench init frappe-bench --frappe-branch version-13
>cd frappe-bench/
>bench start
STEP 14 create a site in frappe bench
>bench new-site yoursite.com
STEP 15 install ERPNext latest version in bench & site
>bench get-app erpnext --branch version-13 --resolve-deps
>bench --site yoursite.com install-app erpnext
>bench start
NOTE:
create "currentsite.txt" at "frappe-bench/sites" folder to solve the issue of 404, currentsite.txt must contain the site name you created using "bench new-site <sitename>"