Installing ERPNext on Fedora 22 & 23

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

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

Installing Bench

Install bench as a non root user:

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