brotherton-erpnext/docs/dev/docs.dev.install.md
2013-11-11 20:52:12 +05:30

66 lines
2.2 KiB
Markdown

---
{
"_label": "How to Install ERPNext",
"_toc": [
"docs.dev.install.restore_from_backup"
]
}
---
> 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](docs.user.intro.try.html).
### ERPNext Installer (Beta)
1. Make sure that you have Python 2.7+
```
$ python -c "import platform; print platform.python_version()"
2.7.3
```
or
```
$ which python2.7
/usr/bin/python2.7
```
If your python version is less than 2.7, then follow,
* For CentOS, you can refer to http://toomuchdata.com/2012/06/25/how-to-install-python-2-7-3-on-centos-6-2/
* For Ubuntu, refer to http://askubuntu.com/questions/101591/how-do-i-install-python-2-7-2-on-ubuntu/101595#101595
1. Make sure the 'passwd' command exists. Install passwd if necessary (e.g. on CentOS, run `yum install passwd`)
1. Switch to root user using `sudo su`
1. `wget https://raw.github.com/webnotes/erpnext/master/install_erpnext.py`
1. `python2.7 install_erpnext.py --create_user`
This will create a user 'erpnext' and install erpnext in its home directory.
To start a development server, login as erpnext with password erpnext (or `su erpnext` from your root shell)
```
cd /home/erpnext/erpnext
./lib/wnf.py --serve
```
> If you are installing on your server for deployment, remember to change Administrator's password!
> You can set the erpnext username and password by passing it to the install script,
`python2.7 install_erpnext.py --create_user --username erpnext_username --password secretpassword`
> If you get stuck, post your questions at [ERPNext Developer Forum](https://groups.google.com/forum/#!forum/erpnext-developer-forum)
> [Troubleshooting SELinux](http://www.crypt.gen.nz/selinux/disable_selinux.html)
--
> [Server Setup Tips](http://plusbryan.com/my-first-5-minutes-on-a-server-or-essential-security-for-linux-servers)
> [MySQL configuration file - my.cnf](https://github.com/webnotes/erpnext/wiki/MySQL-configuration-file)
> [Some Useful Aliases](https://github.com/webnotes/erpnext/wiki/Some-Useful-Aliases)
---
### Upgrade / run latest patches
1. Backup your database!
```
./lib/wnf.py --backup
```
1. Pull changes
```
./lib/wnf.py --update origin master
```