The bench is a command-line utility that helps you to install apps, manage multiple sites and update Frappe / ERPNext apps on */nix (CentOS, Debian, Ubuntu, etc) for development and production. Bench will also create nginx and supervisor config files, setup backups and much more.
If you are using on a VPS make sure it has >= 1Gb of RAM or has swap setup properly.
To do this install, you must have basic information on how Linux works and should be able to use the command-line. If you are looking easier ways to get started and evaluate ERPNext, download the Virtual Machine or take a free trial on erpnext.com.
If you have questions, please ask them on the forum.
You will need a computer/server. Options include:
To install the Frappe/ERPNext server software, you will need an operating system on your normal computer which is not Windows. Note that the command line interface does work on Windows, and you can use Frappe/ERPNext from any operating system with a web browser. However, the server software does not run on Windows. It does run on other operating systems, so choose one of these instead:
To manually install frappe/erpnext, you can follow this this wiki for Linux and this wiki for MacOS. It gives an excellent explanation about the stack. You can also follow the steps mentioned below:
Install bench as a non root user,
git clone https://github.com/frappe/bench bench-repo
pip install --user -e bench-repo
Note: Please do not remove the bench directory the above commands will create
Create a new bench
The init command will create a bench directory with frappe framework installed. It will be setup for periodic backups and auto updates once a day.
bench init frappe-bench && cd frappe-bench
Add a site
Frappe apps are run by frappe sites and you will have to create at least one site. The new-site command allows you to do that.
bench new-site site1.local
Add apps
The get-app command gets remote frappe apps from a remote git repository and installs them. Example: erpnext
bench get-app erpnext https://github.com/frappe/erpnext
Install apps
To install an app on your new site, use the bench install-app
command.
bench --site site1.local install-app erpnext
Start bench
To start using the bench, use the bench start
command
bench start
To login to Frappe / ERPNext, open your browser and go to [your-external-ip]:8000
, probably localhost:8000
The default username is "Administrator" and password is what you set when you created the new site.
apt-get install python-minimal
apt-get install build-essential python-setuptools
password
on a fresh serverOpen your Terminal and enter:
For Linux:
wget https://raw.githubusercontent.com/frappe/bench/master/playbooks/install.py
If you are on a fresh server and logged in as root, use --user flag to create a user and install using that user
python install.py --develop --user frappe
For developer setup:
sudo python install.py --develop
For production:
sudo python install.py --production --user frappe
bench
frappe-bench
by default) and start the bench with bench start
nginx
and supervisor
. Setup Production
Bench Manager is a graphical user interface to emulate the functionalities of Frappé Bench. Like the command line utility it helps you install apps, manage multiple sites, update apps and much more.
$ bench setup manager
What all it does:
bench_manager
app from https://github.com/frappe/bench_manager if it doesn't exist alreadyFor bench help, you can type
bench --help
To manually update the bench, run bench update
to update all the apps, run
patches, build JS and CSS files and restart supervisor (if configured to).
You can also run the parts of the bench selectively.
bench update --pull
will only pull changes in the apps
bench update --patch
will only run database migrations in the apps
bench update --build
will only build JS and CSS files for the bench
bench update --bench
will only update the bench utility (this project)
bench update --requirements
will only update dependencies (python packages) for the apps installed
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。