# serve

URL: /bengal/cli/serve/
Section: cli
Description: Start dev server with hot reload

---

> For a complete page index, fetch /bengal/llms.txt.

Open LLM text
(/bengal/cli/serve/index.txt)

Share with AI

Ask Claude
(https://claude.ai/new?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fbengal%2Fcli%2Fserve%2Findex.txt)

Ask ChatGPT
(https://chatgpt.com/?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fbengal%2Fcli%2Fserve%2Findex.txt)

Ask Gemini
(https://gemini.google.com/app?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fbengal%2Fcli%2Fserve%2Findex.txt)

Ask Copilot
(https://copilot.microsoft.com/?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fbengal%2Fcli%2Fserve%2Findex.txt)

Command

#
`bengal serve`

Start dev server with hot reload

16Options

## Usage

```
bengal serve [OPTIONS]
```

## Options

Option
Type
Description

`--all-versions`

flag

`BOOLEAN`

Build all versions (git versioning mode)

`--auto-port`

flag

`BOOLEAN`

Find available port if specified port is taken

`--complete`

flag

`BOOLEAN`

Wait for deploy-quality artifacts, health checks, and caches before serving

`--config`

`STRING`

Path to config file (default: bengal.toml)

`--debug`

flag

`BOOLEAN`

Show debug output and full tracebacks

`--environment`

`STRING`

Environment: local, preview, production

`--host`

`STRING`

Server host address

Default:`localhost`

`--open-browser`

flag

`BOOLEAN`

Open browser after server starts

`--port`

`INTEGER`

Server port number

Default:`5173`

`--profile`

`STRING`

Config profile: writer, theme-dev, dev

`--source`

`STRING`

Source directory path

`--style`

`STRING`

Output style: dense, ascii, or ci

Default:`dense`

`--traceback`

`STRING`

Traceback verbosity: full | compact | minimal | off

`--verbose`

flag

`BOOLEAN`

Show detailed server activity

`--version-scope`

`STRING`

Focus on single version (e.g., v2, latest)

`--watch`

flag

`BOOLEAN`

Watch for file changes and rebuild