Command

bengal.site.serve

Start development server with hot reload.

Watches for changes in content, assets, and templates, automatically rebuilding the site when files are modified.

Version Scoping (RFC: rfc-versioned-docs-pipeline-integration): --version v2 Focus on single version, faster rebuilds --all-versions Explicitly build all versions (default)

14Options1Argument

Usage

bengal.site.serve [OPTIONS]

Options

Option Type Description
--all-versions flag BOOLEAN

Explicitly build all versions (default behavior, for clarity)
--auto-port flag BOOLEAN

Find available port if specified port is taken (default: enabled)
--config PATH

Path to config file (default: bengal.toml)
--dashboard flag BOOLEAN

Launch interactive Textual dashboard (experimental)
--debug flag BOOLEAN

Show debug output and full tracebacks (port checks, PID files, observer setup)
--environment, -e CHOICE

Environment name (defaults to 'local' for dev server)
--host TEXT

Server host address

Default:localhost
--open, -o flag BOOLEAN

Open browser automatically after server starts (default: enabled)
--port, -p INTEGER

Server port number

Default:5173
--profile CHOICE

Config profile to use: writer, theme-dev, or dev
--traceback CHOICE

Traceback verbosity: full | compact | minimal | off
--verbose, -v flag BOOLEAN

Show detailed server activity (file watches, rebuilds, HTTP details)
--version, -V TEXT

Focus on single version (e.g., v2, latest). Only rebuilds pages for this version.
--watch flag BOOLEAN

Watch for file changes and rebuild (default: enabled)

Arguments

Argument Type Description
source PATH Default:.