Skip to content

Installing ERPNext on Fedora 22 & 23

Yashodhan edited this page Apr 11, 2016 · 4 revisions

This guide is aimed to provide installation instruction for a development environment

Pre-requisite

I started from a plain F22 iso downloaded by the Fedora site. Tested on Bench v5 (Aug 2nd 2015)

Tested with Fedora 23 x64 (4.2.3-300.fc23.x86_64). Tested on Bench v6 (Apr 12th 2016)

Update OS

dnf update && dnf upgrade

Create User (any username of your choice)

adduser frappe
passwd frappe

Add user to sudo/wheel group

gpasswd wheel -a frappe

Install Dependent Packages

sudo dnf install mariadb mariadb-server mariadb-devel python-setuptools nginx zlib-devel bzip2-devel openssl-devel postfix python-devel python-pip libxml2 libxml2-devel libxslt libxslt-devel redis libXrender libXext supervisor cronie which xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 libjpeg-devel redhat-rpm-config python-crypto nodejs npm git

Start and enable redis

sudo systemctl start redis.service
sudo systemctl enable redis.service

Configure MariaDB

Start MariaDB Server

systemctl start mariadb.service
systemctl enable mariadb.service

MariaDB Secure Setup

mysql_secure_installation
Enter current password for root (enter for none): (Press Enter)
Set root password? [Y/n] Y
New password: 
Re-enter new password: 
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

Add the following preferences in /etc/my.cnf

[mysqld]
innodb-file-format=barracuda
innodb-file-per-table=1
innodb-large-prefix=1
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

[mysql]
default-character-set = utf8mb4

Restart MariaDB Server using systemctl restart mariadb.service and check if after updating above config MariaDB Server started successfully systemctl status mariadb.service

Installing Bench

Install bench as a non-root user: (created during pre-requisite steps)

git clone https://github.com/frappe/bench bench-repo
sudo pip install -e bench-repo

Installing ERPNext

Enter in the Frappe dir

bench init frappe-bench
cd frappe-bench
bench get-app erpnext https://github.com/frappe/erpnext         # Add ERPNext to your bench apps
bench new-site site1.local                      # Create a new site
bench install-app erpnext                       # Install ERPNext for the site

Start ERP Next

bench start

Upgrade

New prerequisite nodejs and npm (introduced in bench v6):

sudo dnf install nodejs npm

Issue the following commands:

cd frappe-bench
bench update --upgrade
bench update 
bench setup socketio
bench setup redis-async-broker
bench setup redis-cache