# Stop IPC hosting

Source: https://stratadb.org/docs/reference/admin/ipc_stop

Stop hosting the multi-process broker socket.

| | |
|---|---|
| Command | `admin.ipc_stop` |
| CLI | `strata ipc stop` |
| Wire type | `ipc_stop` |
| Python | `db.admin.ipc_stop() -> 'Any'` |
| Access | write |
| Commit | no commit |
| Wire status | stable |

Stops hosting the same-machine broker socket for this store: the listener stops accepting connections and the store is no longer reachable by new clients. Run from a client, it forwards to the owner, which stops hosting (ending that client's own connection). The store stays open in this process; the socket files are unlinked when the owner closes. Idempotent - a process that was not hosting reports `stopped: false`.

Status commands return a scalar or compact status payload and do not mutate database state.

## Examples

Stop hosting the multi-process broker socket.

### CLI

```console
$ strata ipc stop
```

### Wire

```json
{"type":"ipc_stop"}
```

### Python

```python
db.admin.ipc_stop().stopped
```

## Returns

`StatusResponse<AdminIpcStop>`

- `data` (`AdminIpcStop`)
- `type` (`string`)

## Errors

Recover by code, never by message.

| Code | Retry | Commit outcome |
|---|---|---|
| [`failed_precondition.engine.runtime_closed`](https://stratadb.org/e/failed_precondition.engine.runtime_closed) | never | not_started |

## Related

- [Read sanitized config](https://stratadb.org/docs/reference/admin/config)
- [Read one config value](https://stratadb.org/docs/reference/admin/config_key)
- [Describe database](https://stratadb.org/docs/reference/admin/describe)
- [Read database health](https://stratadb.org/docs/reference/admin/health)
- [Clone hub dataset](https://stratadb.org/docs/reference/admin/hub_clone)
- [Read database info](https://stratadb.org/docs/reference/admin/info)
- [Read IPC status](https://stratadb.org/docs/reference/admin/ipc_status)
- [Read database metrics](https://stratadb.org/docs/reference/admin/metrics)
- [Ping database](https://stratadb.org/docs/reference/admin/ping)
- [Read remote origin](https://stratadb.org/docs/reference/admin/remote)