# benchweave start


Start the gateway detached (supervised surface; stderr to

.log).

:::


``` bash
benchweave start [OPTIONS]
```


Readiness is HOLD-ACQUIRED (the pidfile names the child), not serving readiness; a child dying inside the window exits non-zero with the log tail, never a hung window and never exit-0-over-a-dead-daemon.


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


    Usage: benchweave start [OPTIONS]

      Start the gateway detached (supervised surface; stderr to <dir>.log).

      Readiness is HOLD-ACQUIRED (the pidfile names the child), not serving
      readiness; a child dying inside the window exits non-zero with the log tail,
      never a hung window and never exit-0-over-a-dead-daemon.

    Options:
      --data-dir PATH  At-rest data directory (holds state.sqlite + content/).
                       [required]
      --host TEXT      Bind address the detached serve child uses.  [default:
                       127.0.0.1]
      --port INTEGER   Bind port the detached serve child uses.  [default: 8125]
      --help           Show this message and exit.


# Options


`--data-dir: PATH`  
**Required.** At-rest data directory (holds state.sqlite + content/). Environment variable: `BENCHWEAVE_DATA_DIR`.

`--host: TEXT = 127.0.0.1`  
Bind address the detached serve child uses.

`--port: INTEGER = 8125`  
Bind port the detached serve child uses.