Installing Frappe and ERPNext on Ubuntu 18.04 LTS
Step by step Installation process for frappe and ERPNext on Ubuntu 18.04 LTS
Installing Frappe and ERPNext on Ubuntu 18.04
- Python 3.6+
- Node.js 12
- Redis 5 (caching and realtime updates)
- MariaDB 10.3.x (to run database driven apps)
- yarn 1.12+ (js dependency manager)
- pip 2.0+ (py dependency manager)
- wkhtmltopdf (version 0.12.5 with patched qt) (for pdf generation)
- cron (bench's scheduled jobs: automated certificate renewal, scheduled backups)
- NGINX (proxying multitenant sites in production)
Install git, python and redis:
apt install git python-dev redis-server
apt-get install software-properties-common
If you are on Ubuntu version older than 20.04, run this before installing MariaDB:
apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:800xF1656F24C74CD1D8 add-apt-repository 'deb [arch=amd64,i386,ppc64el] http://ftp.ubuntutw.org/mirror/mariadb/repo/10.3/ubuntu xenial main'
If you are on version Ubuntu 20.04, then MariaDB is available in default repo and you can directly run the below commands to install it:
apt-get update apt-get install mariadb-server-10.3
During this installation you'll be prompted to set the MySQL root password. If you are not prompted, you'll have to initialize the MySQL server setup yourself. You can do that by running the command:
apt-get install libmysqlclient-dev
Remember: only run it if you're not prompted the password during setup. It is really important that you remember this password, since it'll be useful later on. You'll also need the MySQL database development files.
Now, edit the MariaDB configuration file.
And add this configuration
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
default-character-set = utf8mb4
Now, just restart the mysql service and you are good to go.
service mysql restart
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash
After nvm is installed, you may have to close your terminal and open another one. Now run the following command to install node.
nvm install 12
Verify the installation, by running:
Install yarn using npm
npm install -g yarn
apt-get install xvfb libfontconfig wkhtmltopdf
Install Bench CLI
Install bench via pip3
pip3 install frappe-bench
Confirm the bench installation by checking version
# output 13.4.1
Setting up Frappe Bench.
cd ~ bench init frappe-bench
After the frappe-bench folder is created, change your directory to it and run this command
bench get-app https://github.com/frappe/erpnext.git
bench install-app erpnext
Keep bench start on one tab and try on another tab
bench migrate && bench build
Congratulations, you have installed bench and ERPNext on to your system !!!