Skip to main content

Bench CLI

Bench is a command-line utility that helps you install, update, and manage multiple sites for Frappe applications on Unix-like systems. Whether you’re developing locally or deploying to production, Bench streamlines the entire lifecycle of your Frappe applications.

What is Bench?

Bench provides a complete environment for managing Frappe-based applications. It handles everything from initialization and app installation to production setup with NGINX, supervisor, and automated backups.

Multi-tenant Ready

Host multiple sites with different apps on a single bench instance

Production Setup

One-command production environment with NGINX, supervisor, and SSL

App Management

Install, update, and manage Frappe applications effortlessly

Automated Backups

Schedule automatic backups for all your sites

Quick Start

Get up and running with Bench in minutes:

Installation

Install Bench using Docker or manual setup

Quickstart Guide

Create your first bench and site

Core Features

Initialize a complete development environment with a single command. Bench sets up your Python virtual environment, installs dependencies, and configures Redis and MariaDB connections automatically.
Deploy production-ready Frappe applications with automated NGINX configuration, supervisor process management, and Let’s Encrypt SSL certificates.
Create and manage multiple Frappe sites on a single bench instance. Each site can have different apps installed and its own database.
Install apps from GitHub or local repositories. Bench handles dependency resolution, builds assets, and keeps everything synchronized.

bench init

Initialize a new bench

bench get-app

Install applications

bench start

Start development server

bench update

Update bench and apps

bench setup production

Setup for production

bench backup

Backup sites

Learn More

Development Setup

Set up a development environment for building Frappe apps

Production Deployment

Deploy and manage production Frappe instances

Command Reference

Complete reference for all bench commands

Contributing

Contribute to Bench development

Build docs developers (and LLMs) love