Python 3.10+
Node.js 14+
Redis 5 (caching and real time updates)
MariaDB 10.3.x / Postgres 9.5.x (to run database driven apps)
yarn 1.12+ (js dependency manager)
pip 20+ (py dependency manager)
wkhtmltopdf (version 0.12.5 with patched qt) (for pdf generation)
cron (bench's scheduled jobs: automated certificate renewal, scheduled backups)
NGINX
Ubuntu 22.04
Git is the most commonly used version control system. Git tracks the changes you make to files, so you have a record of what has been done, and you can revert to specific versions should you ever need to. Git also makes collaboration easier, allowing changes by multiple people to all be merged into one source.
sudo apt-get install git
python-dev is the package that contains the header files for the Python C API, which is used by lxml because it includes Python C extensions for high performance.
sudo apt-get install python3-dev
Setuptools is a collection of enhancements to the Python distutils that allow developers to more easily build and distribute Python packages, especially ones that have dependencies on other packages. Packages built and distributed using setuptools look to the user like ordinary Python packages based on the distutils.
pip is a package manager for Python. It's a tool that allows you to install and manage additional libraries and dependencies that are not distributed as part of the standard library.
sudo apt-get install python3-setuptools python3-pip
virtualenv is a tool for creating isolated Python environments containing their own copy of python , pip , and their own place to keep libraries installed from PyPI. It's designed to allow you to work on multiple projects with different dependencies at the same time on the same machine.
sudo apt-get install virtualenv
CHECK PYTHON VERSION
python3 -V
sudo apt install python3.10-venv
sudo apt-get install software-properties-common
sudo apt install mariadb-server
sudo mysql_secure_installation
Enter current password for root (enter for none): # PRESS ENTER
OK, successfully used password, moving on...
Switch to unix_socket authentication [Y/n] Y
Enabled successfully!
Reloading privilege tables..
... Success!
Change the root password? [Y/n] Y
New password:
Re-enter new password:
Password updated successfully!
Reloading privilege tables..
... Success!
Remove anonymous users? [Y/n] Y
... Success!
Disallow root login remotely? [Y/n] Y
... Success!
Remove test database and access to it? [Y/n] Y
- Dropping test database...
... Success!
- Removing privileges on test database...
... Success!
Reload privilege tables now? [Y/n] Y
... Success!
sudo apt-get install libmysqlclient-dev
sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf
add this to the my.cnf file after first 3 lines
[server]
user = mysql
pid-file = /run/mysqld/mysqld.pid
socket = /run/mysqld/mysqld.sock
basedir = /usr
datadir = /var/lib/mysql
tmpdir = /tmp
lc-messages-dir = /usr/share/mysql
bind-address = 127.0.0.1
query_cache_size = 16M
log_error = /var/log/mysql/error.log
[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
comment below line
#character-set-server = utf8mb4
#collation-server = utf8mb4_general_ci
add this file to the bottom
[mysql]
default-character-set = utf8mb4
sudo service mysql restart
Redis is an open source (BSD licensed), in-memory data structure store, used as a database, cache, and message broker.
sudo apt-get install redis-server
Node.js is an open source, cross-platform runtime environment for developing server-side and networking applications. Node.js applications are written in JavaScript, and can be run within the Node.js runtime on OS X, Microsoft Windows, and Linux.
sudo apt install curl
curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
source ~/.profile
nvm install 14
Yarn is a JavaScript package manager that aims to be speedy, deterministic, and secure. See how easy it is to drop yarn in where you were using npm before, and get faster, more reliable installs. Yarn is a package manager for JavaScript.
sudo apt-get install npm
sudo npm install -g yarn
Wkhtmltopdf is an open source simple and much effective command-line shell utility that enables user to convert any given HTML (Web Page) to PDF document or an image (jpg, png, etc)
sudo apt-get install xvfb libfontconfig wkhtmltopdf
sudo -H pip3 install frappe-bench
bench --version
If version is not showing restart your system
bench init [bench-name]
bench initialization comes with frappe app from develop branch. we need to install frappe from latest branch branch
for frappe git
bench get-app frappe --branch version-14
for private repo
bench get-app frappe [git_repo_url] --branch [branch_name]
bench new-site [site-name]
*for production setup use your site name here Example:
bench new-site abcd.com
for frappe git
bench get-app erpnext --branch version-14
for private repo
bench get-app erpnext [git_repo_url] --branch [branch_name]
bench get-app payments
bench get-app hrms --branch develop
bench --site [site-name] install-app [app_name]
if you have multiple sites
bench use [site-name]
sudo adduser username
groups username
sudo usermod -aG sudo username
sudo visudo
root ALL=(ALL:ALL) ALL*
Below this line, add the following line. Be sure to change username to the name of the user profile that you would like to grant sudo privileges.
username ALL=(ALL:ALL) ALL
save and close the file by pressing CTRL + X, followed by Y, and then ENTER to confirm.
sudo chmod o+x /home/[bench folder]
sudo apt-get install supervisor
sudo nano /etc/supervisor/supervisord.conf
change permission
chmod=0777
Ctrl + x type y then press Enter to save and exit
sudo service nginx reload
sudo service supervisor restart
sudo bench setup production [username]
sudo reboot
bench restart
if you are facing any error repeat step 21
bench build
bench migrate
once bench restart successfully you can login to your ERP through your domain example.com
Make sure the domain is mapped with your public ip