bench

bench is a command-line utility that helps you to install apps, manage multiple sites and update Frappe / ERPNext apps on */nix (macOS, Ubuntu, Debian, CentOS, etc) for development and production.

Note: If you are looking for easier ways to get started and evaluate ERPNext, download the Virtual Machine or take a free trial on erpnext.com.

bench CLI
Easy Install Script
Release Bench
Guides
Resources
License

bench CLI

Bench is a command line tool that helps you install, setup, manage multiple sites and apps based on Frappe Framework.

Usage

Create a new bench
```
  bench init [bench-name]
```
Add a site under current bench
```
  bench new-site [site-name]
```
Optional: If the database for the site does not reside on localhost or listens on a custom port, you can use the flags --db-host to set a custom host and/or --db-port to set a custom port.
```
  bench new-site [site-name] --db-host [custom-db-host-ip] --db-port [custom-db-port]
```
Add apps to bench
```
  bench get-app [app-name] [app-link]
```

Install apps on a particular site

  bench --site [site-name] install-app [app-name]

Start bench (only for development)
```
  bench start
```
Show bench help
```
  bench --help
```

Note: Apart from bench init, all other bench commands have to be run having the respective bench directory as the working directory. (bench update may also be run, but it's behaviour is covered in depth in the docs)

For more in depth information on commands and usage follow here. As for a consolidated list of bench commands, go through this page.

Installation

To do this install, you must have basic information on how Linux works and should be able to use the command-line. 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.

git clone https://github.com/frappe/bench ~/.bench
pip3 install --user -e ~/.bench

As bench is a python application, its installation really depends on python + pip + git. The Frappe Framework, however has various other system dependencies like nodejs, yarn, redis and a database system like mariadb or postgres. Go through the installation requirements for an updated list.

If you have questions, please ask them on the forum under the "Install / Update" category.

Custom Bench Commands

Want to utilize a bench command you've added in your custom Frappe application? This guide might be of some help.

Easy Install Script

This is an opinionated setup so it is best to setup on a blank server.
Works on Ubuntu 16.04+, CentOS 7+, Debian 8+
You may have to install Python 3 and other essentials by running apt-get install python3-minimal build-essential python3-setuptools
This script will install the pre-requisites, install bench and setup an ERPNext site (site1.local under frappe-bench)
Passwords for Frappe Administrator and MariaDB (root) will be asked and saved under ~/passwoords.txt
MariaDB (root) password may be password on a fresh server
You can then login as Administrator with the Administrator password
The log file is saved under /tmp/logs/install_bench.log in case you run into any issues during the install.
If you find any problems, post them on the forum: https://discuss.erpnext.com with the installation_problem under "Install / Update" category.
```
  wget https://raw.githubusercontent.com/frappe/bench/master/playbooks/install.py
  python3 install.py --production
```

Follow Easy Install Docs for more information.

Release Bench

Releases can be made for Frappe apps using bench. More information about this process can be found here.

Bench Manager (GUI for Bench)

Bench Manager is a graphical user interface to emulate the functionalities of Frappe Bench. Like the command line utility it helps you install apps, manage multiple sites, update apps and much more. Install just by executing the following command in the respective bench directory.

	bench setup manager

ONE-F-M/bench

bench

Table of Contents

bench CLI

Usage

Installation

Custom Bench Commands

Easy Install Script

Release Bench

Bench Manager (GUI for Bench)

Docker

Guides

Resources

License