ERPNext is a free and open supply ERP software program written in Python on prime of the Frappe framework and contains Accounting, Stock, Manufacturing, CRM, Gross sales, Buy, Mission Administration, HRMS and extra. ERPNext is a straightforward, highly effective and simple to make use of ERP system. It comes with lovely net interface that can be utilized to handle the daily duties from a central location.
On this tutorial, we are going to learn to set up ERPNext software program on Debian 9 server.
Stipulations
- A server working Debian 9.
- A non-root person with sudo privileges.
Getting Began
Earlier than beginning, it is suggested to replace your bundle repository to the newest model. You are able to do this by working the next command:
sudo apt-get replace -y
sudo apt-get improve -y
Subsequent, restart the system to use all of the modifications.
Set up Dependencies
ERPNext requires Python model 2.7 as a way to work correctly. You’ll be able to set up Python and different required packages by working the next command:
sudo apt-get set up python-minimal git build-essential python-setuptools python-dev libffi-dev libssl-dev -y
Additionally, you will want to put in Python’s pip device to put in Python dependencies. You are able to do this by working the next command:
wget https://bootstrap.pypa.io/get-pip.py
sudo python get-pip.py
Subsequent, set up ansible utilizing the pip command:
sudo pip set up ansible
Set up Node.js, Redis and Nginx
By default, the newest model of the Node.js just isn’t accessible in Debian 9. So you will want so as to add the Nodesource repository for Node.js 8.x. You are able to do this by working the next command:
sudo curl –silent –location https://deb.nodesource.com/setup_8.x | sudo bash –
Subsequent, set up Node.js, Nginx and Redis by working the next command:
sudo apt-get set up nodejs redis-server nginx -y
As soon as all of the packages are put in, begin Nginx and Redis service and allow them to start out on boot with the next command:
sudo systemctl begin nginx
sudo systemctl allow nginx
sudo systemctl begin redis-server
sudo systemctl allow redis-server
Set up and Configure MariaDB
By default, the newest model of the MariaDB just isn’t accessible in Debian 9 repository. So you will want so as to add MariaDB repository for that.
First, obtain and add signing key to your system with the next command:
sudo apt-get set up software-properties-common dirmngr
sudo apt-key adv –recv-keys –keyserver keyserver.ubuntu.com 0xF1656F24C74CD1D8
Subsequent, add MariaDB repository utilizing the next command:
sudo add-apt-repository ‘deb [arch=amd64,i386,ppc64el] http://ftp.utexas.edu/mariadb/repo/10.2/debian stretch foremost’
Lastly, set up MariaDB server with the next command:
sudo apt-get replace -y
sudo apt-get set up mariadb-server libmysqlclient-dev -y
Subsequent, you will want so as to add the Barracuda storage engine to the MariaDB configuration file for the creation of ERPNext databases. You are able to do this by modifying my.cnf file:
sudo nano /and many others/mysql/my.cnf
add the next strains:
[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
Save and shut the file when you find yourself completed, then begin MariaDB service and allow it to start out on boot with the next command:
sudo systemctl restart mysql
sudo systemctl allow mysql
Subsequent, safe MariaDB by working the mysql_secure_installation script:
sudo mysql_secure_installation
This script will set root password, take away nameless customers, disallow distant root login, and take away the check database and entry to safe MariaDB as proven beneath:
Set root password? [Y/n] y Take away nameless customers? [Y/n] y Disallow root login remotely? [Y/n] y Take away check database and entry to it? [Y/n] y Reload privilege tables now? [Y/n] y
Set up PDF Converter
Additionally, you will want to put in wkhtmltopdf to converts HTML into PDF utilizing the QT Webkit rendering engine. First, set up required dependencies utilizing the next command:
sudo apt-get set up libxext6 xfonts-75dpi xfonts-base libxrender1 -y
Subsequent, obtain the newest model of wkhtmltopdf utilizing the next command:
wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz
Subsequent, extract the downloaded file to the /choose listing:
sudo tar -xvf wkhtmltox-0.12.4_linux-generic-amd64.tar.xz -C /choose
Subsequent, create a softlink for wkhtmltopdf utilizing the next command:
sudo ln -s /choose/wkhtmltox/bin/wkhtmltopdf /usr/bin/wkhtmltopdf
sudo ln -s /choose/wkhtmltox/bin/wkhtmltopdf /usr/bin/wkhtmltopdf
Set up Bench
Subsequent, you will want to put in Bench to put in and handle the ERPNext software to your system. Bench can also be used to create and handle Nginx and supervisor configurations.
Earlier than putting in Bench, you will want so as to add person for Bench.
First, create a Bench person with the next command:
sudo adduser bench
Subsequent, present sudo permissions to the bench person.
sudo usermod -aG sudo bench
Subsequent, login with Bench person and clone the Bench repository with the next command:
su – bench
git clone https://github.com/frappe/bench bench-repo
Lastly, set up Bench utilizing the pip command:
sudo pip set up -e bench-repo
Set up ERPNext
Subsequent, initialize a bench listing with frappe framework put in.
bench init erpnext
Subsequent, change the listing to the erpnext and create a brand new Frappe web site with the next command:
cd erpnext
bench new-site check.instance.com
The above command will ask to supply the MySQL root password and ask you to set a brand new password for the administrator account. The administrator password might want to log into the administrator dashboard later.
Subsequent, obtain ERPNext set up information from Git repository with the next command:
bench get-app erpnext https://github.com/frappe/erpnext
Subsequent, Set up ERPNext in your newly created web site.
bench –site check.instance.com install-app erpnext
Lastly, begin the Bench software with the next command:
bench begin
As soon as the applying began efficiently, it is best to see the next output:
13:40:10 system | redis_socketio.1 began (pid=2618) 13:40:10 system | worker_long.1 began (pid=2625) 13:40:10 system | watch.1 began (pid=2619) 13:40:10 system | redis_queue.1 began (pid=2626) 13:40:10 redis_socketio.1 | 2630:M 24 Feb 13:40:10.939 * Elevated most variety of open information to 10032 (it was initially set to 1024). 13:40:10 system | net.1 began (pid=2629) 13:40:11 system | schedule.1 began (pid=2634) 13:40:10 redis_socketio.1 | _._ 13:40:10 redis_socketio.1 | _.-``__ ''-._ 13:40:10 redis_socketio.1 | _.-`` `. `_. ''-._ Redis 3.0.6 (00000000/0) 64 bit 13:40:10 redis_socketio.1 | .-`` .-```. ```/ _.,_ ''-._ 13:40:10 redis_socketio.1 | ( ' , .-` | `, ) Operating in standalone mode 13:40:10 redis_socketio.1 | |`-._`-...-` __...-.``-._|'` _.-'| Port: 12000 13:40:10 redis_socketio.1 | | `-._ `._ / _.-' | PID: 2630 13:40:10 redis_socketio.1 | `-._ `-._ `-./ _.-' _.-' 13:40:10 redis_socketio.1 | |`-._`-._ `-.__.-' _.-'_.-'| 13:40:10 redis_socketio.1 | | `-._`-._ _.-'_.-' | http://redis.io 13:40:10 redis_socketio.1 | `-._ `-._`-.__.-'_.-' _.-' 13:40:10 redis_socketio.1 | |`-._`-._ `-.__.-' _.-'_.-'| 13:40:10 redis_socketio.1 | | `-._`-._ _.-'_.-' | 13:40:10 redis_socketio.1 | `-._ `-._`-.__.-'_.-' _.-' 13:40:10 redis_socketio.1 | `-._ `-.__.-' _.-' 13:40:10 redis_socketio.1 | `-._ _.-' 13:40:10 redis_socketio.1 | `-.__.-' 13:40:10 redis_socketio.1 | 13:40:11 system | worker_default.1 began (pid=2639) 13:40:10 redis_socketio.1 | 2630:M 24 Feb 13:40:10.973 # WARNING: The TCP backlog setting of 511 can't be enforced as a result of /proc/sys/internet/core/somaxconn is ready to the decrease worth of 128. 13:40:10 redis_socketio.1 | 2630:M 24 Feb 13:40:10.974 # Server began, Redis model 3.0.6 13:40:10 redis_socketio.1 | 2630:M 24 Feb 13:40:10.974 # WARNING overcommit_memory is ready to 0! Background save might fail below low reminiscence situation. To repair this situation add 'vm.overcommit_memory = 1' to /and many others/sysctl.conf after which reboot or run the command 'sysctl vm.overcommit_memory=1' for this to take impact. 13:40:10 redis_socketio.1 | 2630:M 24 Feb 13:40:10.974 # WARNING you've got Clear Large Pages (THP) assist enabled in your kernel. This can create latency and reminiscence utilization points with Redis. To repair this situation run the command 'echo by no means > /sys/kernel/mm/transparent_hugepage/enabled' as root, and add it to your /and many others/rc.native as a way to retain the setting after a reboot. Redis have to be restarted after THP is disabled. 13:40:10 redis_queue.1 | 2635:M 24 Feb 13:40:10.976 * Elevated most variety of open information to 10032 (it was initially set to 1024). 13:40:10 redis_queue.1 | _._ 13:40:10 redis_queue.1 | _.-``__ ''-._ 13:40:10 redis_queue.1 | _.-`` `. `_. ''-._ Redis 3.0.6 (00000000/0) 64 bit 13:40:10 redis_queue.1 | .-`` .-```. ```/ _.,_ ''-._ 13:40:10 redis_queue.1 | ( ' , .-` | `, ) Operating in standalone mode 13:40:10 redis_queue.1 | |`-._`-...-` __...-.``-._|'` _.-'| Port: 11000 13:40:10 redis_queue.1 | | `-._ `._ / _.-' | PID: 2635 13:40:10 redis_queue.1 | `-._ `-._ `-./ _.-' _.-' 13:40:10 redis_queue.1 | |`-._`-._ `-.__.-' _.-'_.-'| 13:40:10 redis_queue.1 | | `-._`-._ _.-'_.-' | http://redis.io 13:40:10 redis_queue.1 | `-._ `-._`-.__.-'_.-' _.-' 13:40:10 redis_queue.1 | |`-._`-._ `-.__.-' _.-'_.-'| 13:40:10 redis_queue.1 | | `-._`-._ _.-'_.-' | 13:40:10 redis_queue.1 | `-._ `-._`-.__.-'_.-' _.-' 13:40:10 redis_queue.1 | `-._ `-.__.-' _.-' 13:40:10 redis_queue.1 | `-._ _.-' 13:40:10 redis_queue.1 | `-.__.-' 13:40:10 redis_queue.1 | 13:40:10 redis_queue.1 | 2635:M 24 Feb 13:40:10.998 # WARNING: The TCP backlog setting of 511 can't be enforced as a result of /proc/sys/internet/core/somaxconn is ready to the decrease worth of 128. 13:40:10 redis_queue.1 | 2635:M 24 Feb 13:40:10.999 # Server began, Redis model 3.0.6 13:40:11 redis_queue.1 | 2635:M 24 Feb 13:40:11.000 # WARNING overcommit_memory is ready to 0! Background save might fail below low reminiscence situation. To repair this situation add 'vm.overcommit_memory = 1' to /and many others/sysctl.conf after which reboot or run the command 'sysctl vm.overcommit_memory=1' for this to take impact. 13:40:11 redis_socketio.1 | 2630:M 24 Feb 13:40:11.000 * The server is now prepared to just accept connections on port 12000 13:40:11 system | socketio.1 began (pid=2637) 13:40:11 redis_queue.1 | 2635:M 24 Feb 13:40:11.029 # WARNING you've got Clear Large Pages (THP) assist enabled in your kernel. This can create latency and reminiscence utilization points with Redis. To repair this situation run the command 'echo by no means > /sys/kernel/mm/transparent_hugepage/enabled' as root, and add it to your /and many others/rc.native as a way to retain the setting after a reboot. Redis have to be restarted after THP is disabled. 13:40:11 redis_queue.1 | 2635:M 24 Feb 13:40:11.029 * The server is now prepared to just accept connections on port 11000 13:40:11 system | redis_cache.1 began (pid=2652) 13:40:11 system | worker_short.1 began (pid=2651) 13:40:11 redis_cache.1 | 2660:M 24 Feb 13:40:11.100 * Elevated most variety of open information to 10032 (it was initially set to 1024). 13:40:11 redis_cache.1 | _._ 13:40:11 redis_cache.1 | _.-``__ ''-._ 13:40:11 redis_cache.1 | _.-`` `. `_. ''-._ Redis 3.0.6 (00000000/0) 64 bit 13:40:11 redis_cache.1 | .-`` .-```. ```/ _.,_ ''-._ 13:40:11 redis_cache.1 | ( ' , .-` | `, ) Operating in standalone mode 13:40:11 redis_cache.1 | |`-._`-...-` __...-.``-._|'` _.-'| Port: 13000 13:40:11 redis_cache.1 | | `-._ `._ / _.-' | PID: 2660 13:40:11 redis_cache.1 | `-._ `-._ `-./ _.-' _.-' 13:40:11 redis_cache.1 | |`-._`-._ `-.__.-' _.-'_.-'| 13:40:11 redis_cache.1 | | `-._`-._ _.-'_.-' | http://redis.io 13:40:11 redis_cache.1 | `-._ `-._`-.__.-'_.-' _.-' 13:40:11 redis_cache.1 | |`-._`-._ `-.__.-' _.-'_.-'| 13:40:11 redis_cache.1 | | `-._`-._ _.-'_.-' | 13:40:11 redis_cache.1 | `-._ `-._`-.__.-'_.-' _.-' 13:40:11 redis_cache.1 | `-._ `-.__.-' _.-' 13:40:11 redis_cache.1 | `-._ _.-' 13:40:11 redis_cache.1 | `-.__.-' 13:40:11 redis_cache.1 | 13:40:11 redis_cache.1 | 2660:M 24 Feb 13:40:11.115 # WARNING: The TCP backlog setting of 511 can't be enforced as a result of /proc/sys/internet/core/somaxconn is ready to the decrease worth of 128. 13:40:11 redis_cache.1 | 2660:M 24 Feb 13:40:11.115 # Server began, Redis model 3.0.6 13:40:11 redis_cache.1 | 2660:M 24 Feb 13:40:11.115 # WARNING overcommit_memory is ready to 0! Background save might fail below low reminiscence situation. To repair this situation add 'vm.overcommit_memory = 1' to /and many others/sysctl.conf after which reboot or run the command 'sysctl vm.overcommit_memory=1' for this to take impact. 13:40:11 redis_cache.1 | 2660:M 24 Feb 13:40:11.116 # WARNING you've got Clear Large Pages (THP) assist enabled in your kernel. This can create latency and reminiscence utilization points with Redis. To repair this situation run the command 'echo by no means > /sys/kernel/mm/transparent_hugepage/enabled' as root, and add it to your /and many others/rc.native as a way to retain the setting after a reboot. Redis have to be restarted after THP is disabled. 13:40:11 redis_cache.1 | 2660:M 24 Feb 13:40:11.116 * The server is now prepared to just accept connections on port 13000 13:40:16 socketio.1 | listening on *: 9000 13:40:34 worker_long.1 | 13:40:34 RQ employee u'rq:employee:Node1.2632.lengthy' began, model 0.10.0 13:40:34 worker_long.1 | 13:40:34 *** Listening on lengthy... 13:40:34 worker_long.1 | 13:40:34 Cleansing registries for queue: lengthy 13:40:34 worker_default.1 | 13:40:34 RQ employee u'rq:employee:Node1.2646.default' began, model 0.10.0 13:40:34 worker_default.1 | 13:40:34 *** Listening on default... 13:40:34 worker_default.1 | 13:40:34 Cleansing registries for queue: default 13:40:34 worker_short.1 | 13:40:34 RQ employee u'rq:employee:Node1.2661.brief' began, model 0.10.0 13:40:34 worker_short.1 | 13:40:34 *** Listening on brief... 13:40:34 worker_short.1 | 13:40:34 Cleansing registries for queue: brief 13:40:34 net.1 | * Operating on http://0.0.0.0:8000/ (Press CTRL+C to give up)
Entry ERPNext Web Interface
ERPNext is now put in and runs on port 8000. It is time to Entry ERPNext Web Interface.
Open your net browser and kind the URL http://test.exaple.com:8000, you’ll be redirected to the next web page:
Right here, present your Administrator account credential and click on on the Sign up button, it is best to see the next web page:
Right here, select English language and click on on the Subsequent button, it is best to see the next web page:
Right here, select your Nation, Time Zone and Forex, then click on on the Subsequent button, it is best to see the next web page:
Right here, present your Title, E-mail and Password, then click on on the Subsequent button, it is best to see the next web page:
Right here, choose your Area as you would like, then click on on the Subsequent button, it is best to see the next web page:
Right here, present your Firm identify and abbreviation, then click on on the Subsequent button, it is best to see the next web page:
Right here, present your Group particulars and click on on the Full Setup button, it is best to see the next web page:
Right here, set a goal you wish to obtain to your Firm, then click on on the Create button, it is best to see the next web page:
Right here, click on on the Subsequent button to proceed, it is best to see the next web page:
Right here, add clients you wish to add, then click on on the Create button, it is best to see the next web page:
Right here, click on on the Subsequent button to proceed, it is best to see the next web page:
Right here, add your suppliers you wish to add, then click on on the Create button, it is best to see the next web page:
Right here, click on on the Subsequent button to proceed, it is best to see the next web page:
Right here, add your services and products you wish to purchase or promote, then click on on the Create button, it is best to see the next web page:
Right here, click on on the Subsequent button to proceed, it is best to see the next web page:
Right here, add customers to your group, then click on on the Create button, it is best to see the ERPNext dashboard following web page:
Conclusion
Congratulations! you’ve got efficiently put in and configured ERPNext on Debian 9 server. Now you can simply use the applying to handle your organization. For extra data, please discuss with the official ERPNext documentation web page at Doc.
Comments