brotherton-erpnext/docs/docs.dev.install.md

_label	_toc
How to Install ERPNext	docs.dev.install.red_hat docs.dev.install.debian

These are instructions that will help you to install ERPNext on your Unix like system (Linux / Ubuntu / MacOS) using the Terminal. If you are looking at easier ways to evaluate ERPNext, see this page.

1. You will need some linux background to be able to install this on your system.
2. These are high-level instructions and by no means cover every installation issue.

Pre-requisites:

• any unix based os
• python 2.6+ (python 3+ not supported)
• apache
• mysql 5+
• git
• python libraries:
  • python MySQLdb
  • pytz
  • jinja2
  • markdown2
  • dateutil
  • termcolor
  • python-memcached
  • requests
  • chardet
  • pygeoip
  • dropbox
  • google-api-python-client
• memcached

Fresh Installation

Steps: [using terminal]

Get the Install Script

Download the standard install script and install. This script will:

• Create app and lib folders.
• Clone the code repositories for wnframework and erpnext from GitHub. It is important to clone the repositories from GitHub rather than just downloading the code, because this will help you in upgrading the system.
• Create the database.
• Create a default erpnext.conf Apache configuration file for ERPnext.
• Create the standard wnframework configuration file conf.py
• Build the public folder from which the ERPNext client application will be served via Apache and CGI.

Instructions

1. ensure mysql service is running
2. create a folder where you want to install erpnext
3. go to the new folder
4. wget https://github.com/webnotes/erpnext/blob/master/install_erpnext.py
5. python install_erpnext.py

Setup Apache

1. check your apache/httpd user and group. Most often it is either apache or _www. This can be found in its conf file.
2. run chown -R apache:apache * or chown -R _www:_www *. This will make the erpnext folder accessible to apache webserver.
3. create erpnext.conf file in erpnext folder and paste a modified version of apache configuration file as shown in the example below. (You will need to change the values in square brackets)
   • For debian systems, sudo ln -s [PATH TO ERPNEXT INSTALLATION]/erpnext.conf /etc/apache2/sites-enabled/erpnext.conf
   • For redhat systems, sudo ln -s [PATH TO ERPNEXT INSTALLATION]/erpnext.conf /etc/httpd/conf.d/erpnext.conf
4. restart apache service
5. if firewall exists, run

iptables -I INPUT 1 -p tcp --dport 8080 -j ACCEPT
service iptables save

Setup Schueduler

1. setup cron using crontab -e and enter the following and then save it:

*/3 * * * * cd [PATH TO ERPNEXT INSTALLATION] && python lib/wnf.py --run_scheduler >> /var/log/erpnext-sch.log 2>&1
0 */6 * * * cd [PATH TO ERPNEXT INSTALLATION] && python lib/wnf.py --backup >> /var/log/erpnext-backup.log 2>&1

Start

1. go to erpnext folder and run lib/wnf.py --domain localhost:8080
2. start your browser and go to http://localhost:8080
3. login as user: Administrator and password: admin

If you are installing on your server for deployment, remember to change Administrator's password!

What to write in apache configuration file?

Listen 8080
NameVirtualHost *:8080
<VirtualHost *:8080>
	ServerName localhost
	DocumentRoot [PATH TO ERPNEXT INSTALLATION]/public/
	
	AddHandler cgi-script .cgi .xml .py
	AddType application/vnd.ms-fontobject .eot
	AddType font/ttf .ttf
	AddType font/otf .otf
	AddType application/x-font-woff .woff

	<Directory [PATH TO ERPNEXT INSTALLATION]/public/>
		# directory specific options
		Options -Indexes +FollowSymLinks +ExecCGI
	
		# directory's index file
		DirectoryIndex web.py
		
		AllowOverride all
		Order Allow,Deny
		Allow from all

		# rewrite rule
		RewriteEngine on
		RewriteCond %{REQUEST_FILENAME} !-f
		RewriteCond %{REQUEST_FILENAME} !-d
		RewriteCond %{REQUEST_FILENAME} !-l
		RewriteRule ^([^/]+)$ /web.py?page=$1 [QSA,L]		
	</Directory>
</VirtualHost>

Upgrade / run latest patches

1. Backup your database!
2. go to Setup > Update This Application [under Update Manager]
3. click on 'Get Latest Updates'

If you cannot see this option (Update This Application), you will need to run a manual update once

1. go your erpnext folder i.e. cd /var/www/erpnext
2. run lib/wnf.py --update origin master
3. run chown -R apache:apache * or chown -R _www:_www *. This will make the erpnext folder accessible to apache webserver.
4. once done, you can use Setup > Update This Application, henceforth.

---

Looking for a one click installer? Help us build one.