CLI to manage Multi-tenant deployments for Frappe apps
Alternatives To Bench
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
6 days ago2February 25, 2019118mitPython
🔎 Hunt down social media accounts by username across social networks
Dive36,14215 days ago28July 02, 2021152mitGo
A tool for exploring each layer in a docker image
Awesome Cheatsheets32,846
5 days ago86mitJavaScript
👩‍💻👨‍💻 Awesome cheatsheets for popular programming languages, frameworks and development tools. They include everything you should know in one single file.
N8n29,01011162a day ago120September 23, 2022295otherTypeScript
Free and source-available fair-code licensed workflow automation tool. Easily automate tasks across different services.
8 days ago31mitC#
Cross-platform .NET sample microservices and container based application that runs on Linux Windows and macOS. Powered by .NET 7, Docker Containers and Azure Kubernetes Services. Supports Visual Studio, VS for Mac and CLI based environments with Docker CLI, dotnet CLI, VS Code or any other code editor.
21 days ago23March 24, 202290mitGo
Top-like interface for container metrics
Devops Guide6,318
21 days ago5mitHTML
DevOps Guide - Development to Production all configurations with basic notes to debug efficiently.
Aws Sam Cli6,2363112a day ago129June 29, 2022361apache-2.0Python
CLI tool to build, test, debug, and deploy Serverless applications using AWS SAM
Buildah6,109456a day ago308September 21, 202257apache-2.0Go
A tool that facilitates building OCI images.
Miniserve4,4061a day ago1March 03, 202170mitRust
🌟 For when you really just want to serve some files over HTTP right now!
Alternatives To Bench
Select To Compare

Alternative Project Comparisons


Bench is a command-line utility that helps you to install, update, and manage multiple sites for Frappe/ERPNext applications on *nix systems for development and production.

Table of Contents


A typical bench setup provides two types of environments — Development and Production.

The setup for each of these installations can be achieved in multiple ways:

We recommend using either the Docker Installation or the Easy Install Script to setup a Production Environment. For Development, you may choose either of the three methods to setup an instance.

Otherwise, if you are looking to evaluate ERPNext, you can also download the Virtual Machine Image or register for a free trial on

Docker Installation

A Frappe/ERPNext instance can be setup and replicated easily using Docker. The officially supported Docker installation can be used to setup either of both Development and Production environments.

To setup either of the environments, you will need to clone the official docker repository:

$ git clone
$ cd frappe_docker

A quick setup guide for both the envionments can be found below. For more details, check out the Frappe/ERPNext Docker Repository.

Docker Installation for Development

To setup a development environment for Docker, follow the Frappe/ERPNext Docker for Development Guide.

Docker Installation for Production

Copy the env-example file to .env

$ cp installation/env-example installation/.env

Make a directory for handling sites:

$ mkdir installation/sites

Optionally, you may also setup an NGINX Proxy for SSL Certificates with auto-renewal for your Production instance. We recommend this for instances being accessed over the internet. For this to work, the DNS needs to be configured correctly so that LetsEncrypt can verify the domain. To setup the proxy, run the following commands:

$ git clone
$ cd docker-compose-letsencrypt-nginx-proxy-companion
$ cp .env.sample .env
$ ./

To get the Production instance running, run the following command:

$ docker-compose \
    --project-name <project-name> \
    -f installation/docker-compose-common.yml \
    -f installation/docker-compose-erpnext.yml \
    -f installation/docker-compose-networks.yml \
    --project-directory installation up -d

Make sure to replace <project-name> with whatever you wish to call it. This should get the instance running through docker. Now, to create a new site on the instance you may run:

docker exec -it \
    -e "INSTALL_APPS=erpnext" \ # optional, if you want to install any other apps
    <project-name>_erpnext-python_1 new

Once this is done, you may access the instance at $SITE_NAME.

Note: The Production setup does not contain, require, or use bench. For a list of substitute commands, check out the Frappe/ERPNext Docker Site Operations.

Easy Install Script

The Easy Install script should get you going with a Frappe/ERPNext setup with minimal manual intervention and effort. Since there are a lot of configurations being automatically setup, we recommend executing this script on a fresh server.

Note: This script works only on GNU/Linux based server distributions, and has been designed and tested to work on Ubuntu 16.04+, CentOS 7+, and Debian-based systems.


You need to install the following packages for the script to run:

  • Ubuntu and Debian-based Distributions:
    $ apt install python3-minimal build-essential python3-setuptools
  • CentOS and other RPM Distributions:
    $ dnf groupinstall "Development Tools"
    $ dnf install python3


Download the Easy Install script and execute it:

$ wget
$ python3 --production

The script should then prompt you for the MySQL root password and an Administrator password for the Frappe/ERPNext instance, which will then be saved under $HOME/passwords.txt of the user used to setup the instance. This script will then install the required stack, setup bench and a default ERPNext instance.

When the setup is complete, you will be able to access the system at http://<your-server-ip>, wherein you can use the administrator password to login.


In case the setup fails, the log file is saved under /tmp/logs/install_bench.log. You may then:

  • Create an Issue in this repository with the log file attached.
  • Search for an existing issue or post the log file on the Frappe/ERPNext Discuss Forum with the tag installation_problem under "Install/Update" category.

For more information and advanced setup instructions, check out the Easy Install Documentation.

Manual Installation

Although not recommended, some might want to manually setup a bench instance locally for development. To quickly get started on installing bench the hard way, you can follow Installing Bench and Frappe.

For more extensive distribution-dependent documentation, check out the following guides:

Basic Usage

Note: Apart from bench init, all other bench commands are expected to be run in the respective bench directory.

  • 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]
  • Download and add applications 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

For more in-depth information on commands and their usage, follow Commands and Usage. As for a consolidated list of bench commands, check out Bench Usage.

Custom Bench Commands

If you wish to extend the capabilities of bench with your own custom Frappe Application, you may follow Adding Custom Bench Commands.

Bench Manager

Bench Manager is a GUI frontend for Bench with the same functionalties. You can install it by executing the following command:

$ bench setup manager
  • Note: This will create a new site to setup Bench Manager, if you want to set it up on an existing site, run the following commands:

    $ bench get-app
    $ bench --site <sitename> install-app bench_manager


For an exhaustive list of guides, check out Bench Guides.


For an exhaustive list of resources, check out Bench Resources.


This repository has been released under the GNU GPLv3 License.

Popular Command Line Projects
Popular Docker Projects
Popular Command Line Interface Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.