Skip to main content
The bench config command group provides utilities for managing bench-wide configuration settings. These commands allow you to modify the common site config and control various bench behaviors.

​
Available Commands

Common Config

Set and remove common configuration keys

Production Settings

Configure supervisor, systemd, and production behaviors

​
Configuration File

All config commands modify the common_site_config.json file in your bench directory. This file contains bench-wide settings that apply to all sites unless overridden at the site level.

​
Common Use Cases

​
Setting Custom Configuration

# Set multiple config values
bench config set-common-config -c db_host localhost -c db_port 3306

# Set boolean values
bench config set-common-config -c developer_mode true

​
Managing Auto-Restart Behavior

# Enable supervisor auto-restart on update
bench config restart_supervisor_on_update on

# Enable systemd auto-restart on update
bench config restart_systemd_on_update on

​
Production Configuration

# Enable DNS-based multitenancy
bench config dns_multitenant on

# Configure default site serving
bench config serve_default_site on

​
Configuration Scope

Changes made through bench config commands affect all sites in the bench. For site-specific configuration, use bench --site [sitename] set-config instead.

Build docs developers (and LLMs) love

Get started for freeTalk to us