Production Settings

​

restart_supervisor_on_update

bench config restart_supervisor_on_update {on|off}

​

Arguments

​

Examples

# Enable auto-restart
bench config restart_supervisor_on_update on

# Disable auto-restart
bench config restart_supervisor_on_update off

​

When to Use

• Running production benches
• You want automatic service restarts after updates
• Using supervisor for process management

• You want manual control over restarts
• Running maintenance windows
• Testing updates before restart

​

restart_systemd_on_update

bench config restart_systemd_on_update {on|off}

​

Arguments

​

Examples

# Enable auto-restart for systemd
bench config restart_systemd_on_update on

# Disable auto-restart
bench config restart_systemd_on_update off

​

When to Use

• Using systemd instead of supervisor
• Running on modern Linux distributions
• Want automatic service management

​

dns_multitenant

bench config dns_multitenant {on|off}

​

Arguments

​

Examples

# Enable DNS multitenancy
bench config dns_multitenant on

# Disable DNS multitenancy
bench config dns_multitenant off

​

What is DNS Multitenancy?

• Route requests based on the domain name
• Allow multiple sites with different domains
• Automatically serve the correct site based on the Host header

​

Configuration

1. Create sites with domain names:
   bench new-site tenant1.example.com
   bench new-site tenant2.example.com
   
2. Configure DNS: Point all domains to your server’s IP
3. Update nginx:
   bench setup nginx
   sudo service nginx reload
   

​

serve_default_site

bench config serve_default_site {on|off}

​

Arguments

​

Examples

# Enable default site serving
bench config serve_default_site on

# Disable default site serving
bench config serve_default_site off

​

Use Cases

• On: Serve a specific site when accessing the server by IP
• Off: Require domain-based routing for all sites

​

rebase_on_pull

bench config rebase_on_pull {on|off}

​

Arguments

​

Examples

# Enable rebase on pull
bench config rebase_on_pull on

# Disable rebase (use merge)
bench config rebase_on_pull off

​

Git Behavior

• On: Uses git pull --rebase for cleaner history
• Off: Uses git pull (merge) - safer for production

​

http_timeout

bench config http_timeout SECONDS

​

Arguments

​

Examples

# Set 5 minute timeout
bench config http_timeout 300

# Set 30 second timeout
bench config http_timeout 30

# Set 2 minute timeout
bench config http_timeout 120

​

When to Adjust

• Working with slow connections
• Downloading large apps
• Operating in high-latency environments

• You want faster failure detection
• Working on fast local networks

​

Complete Production Setup Example

# Configure a production bench
bench config restart_supervisor_on_update on
bench config dns_multitenant on
bench config serve_default_site off
bench config rebase_on_pull off
bench config http_timeout 120

# Regenerate configuration
bench setup nginx
bench setup supervisor

# Reload services
sudo service nginx reload
sudo service supervisor restart

​

Configuration Summary