# frappe/bench

CLI to manage Multi-tenant deployments for Frappe apps

Repository: https://github.com/frappe/bench
Canonical: https://ross.abutalabs.com/products/bench
Homepage: https://frappeframework.com/docs/user/en/bench
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: frappe-bench, cli, frappe-framework, setup-bench, python
Last push: 2026-08-11T07:04:09+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 89, longevity 100
- inputs: {"age_days": 4438, "days_push": 22, "days_rel": 78, "gap_med": 5, "n_releases_24m": 22}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1722, forks 1353 (observed 2026-08-28T04:05:27.741944+00:00)

## What it is
Bench is a Python command-line utility for installing, updating, and managing multiple Frappe framework sites and apps on Unix-like systems. It supports both development and production environments, including site creation, app installation, and backups.

## Use cases
- set up a frappe development environment
- manage multiple frappe sites on one server
- create and install frappe apps
- back up and restore frappe sites
- deploy erpnext in production
- update frappe framework sites

## When to choose
- you develop or deploy Frappe/ERPNext applications
- you need multi-tenant management of Frappe sites on Linux or macOS
- you want scripted site creation, updates, and backups

## When to avoid
- you are not using the Frappe framework ecosystem
- you need Windows-native support
- you prefer a fully containerized workflow without bench (use frappe_docker directly)

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, deployment, developer-tools, configuration-management, backup
- domain: developer-tools, web-development, self-hosted
- platform: cli, python
- tags: frappe, frappe-framework, multi-tenant, site-management, erpnext, low-code, command-line, devops, linux, macos, docker

## Member repositories
- frappe/bench (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:27.741944+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:33:59.594023+00:00, confidence not recorded.
  - readme: https://github.com/frappe/bench (fetched 2026-08-28T04:05:27.741944+00:00, sha 16c872827756)
  - homepage: https://frappeframework.com/docs/user/en/bench (fetched 2026-08-29T11:09:43.832602+00:00, sha fb5cc7a2b333)
  - site_page: https://docs.frappe.io/framework/user/en/bench/reference/uninstall-app (fetched 2026-08-29T11:09:43.851920+00:00, sha 4904aba5c7f5)
  - site_page: https://docs.frappe.io/framework/user/en/installation (fetched 2026-08-29T11:09:43.841385+00:00, sha 6c79d5f089de)
  - site_page: https://docs.frappe.io/framework/user/en/tutorial/install-and-setup-bench (fetched 2026-08-29T11:09:43.843195+00:00, sha 0a48a8d0b0ad)
  - site_page: https://docs.frappe.io/framework/user/en/tutorial/doctype-features (fetched 2026-08-29T11:09:43.844846+00:00, sha e8055eb22807)
  - site_page: https://docs.frappe.io/framework/doctypes/docstatus (fetched 2026-08-29T11:09:43.846377+00:00, sha 7140cb0ed383)
  - site_page: https://docs.frappe.io/framework/user/en/security-faqs (fetched 2026-08-29T11:09:43.847794+00:00, sha aacbac26e29d)
  - site_page: https://docs.frappe.io/framework/user/en/guides/app-development/how-to-create-custom-fields-during-app-installation (fetched 2026-08-29T11:09:43.849216+00:00, sha 20716bb50d4e)
  - site_page: https://docs.frappe.io/framework/user/en/bench/reference/reinstall (fetched 2026-08-29T11:09:43.850578+00:00, sha 56e328a86c7d)
- Data as of 2026-08-30T08:39:29.467469+00:00.