# benchweave serve


Run a BenchWeave gateway locally (foreground; systemd Type=simple).


``` bash
benchweave serve [OPTIONS]
```


Wires the environment into :func:`app_entry.build` -- the same composition the integration suites boot -- and runs it under uvicorn in the FOREGROUND (`uvicorn.run` blocks; daemonization belongs to the service manager, which is why the unit is `Type=simple`). The production secret posture is enforced inside `build`: with `BENCHWEAVE_ENV=production` a default/absent `BENCHWEAVE_SECRET` refuses before anything touches disk.


<span class="gd-details-chevron" aria-hidden="true"></span>Full --help output


    Usage: benchweave serve [OPTIONS]

      Run a BenchWeave gateway locally (foreground; systemd Type=simple).

      Wires the environment into :func:`app_entry.build` -- the same composition
      the integration suites boot -- and runs it under uvicorn in the FOREGROUND
      (``uvicorn.run`` blocks; daemonization belongs to the service manager, which
      is why the unit is ``Type=simple``). The production secret posture is
      enforced inside ``build``: with ``BENCHWEAVE_ENV=production`` a
      default/absent ``BENCHWEAVE_SECRET`` refuses before anything touches disk.

    Options:
      --host TEXT     Bind address (loopback by default -- the gateway is local-
                      only).  [default: 127.0.0.1]
      --port INTEGER  Bind port.  [default: 8125]
      --help          Show this message and exit.


# Options


`--host: TEXT = 127.0.0.1`  
Bind address (loopback by default -- the gateway is local-only). Environment variable: `BENCHWEAVE_HOST`.

`--port: INTEGER = 8125`  
Bind port. Environment variable: `BENCHWEAVE_PORT`.