---
title: Setup and checks
description: Local boot, operational scripts, and runbooks that matter day to day.
---

Canonical detail lives in the repo runbooks ([`docs/runbooks/local-dev.md`](https://github.com/blinqx-hq/basenet-rebuild-poc/blob/main/docs/runbooks/local-dev.md)); this page keeps the essentials.

## Local setup

```bash
git submodule update --init
corepack enable && pnpm install
pnpm dev
```

`pnpm dev` boots Docker Compose services, provisions the demo tenant, and starts web (:3000), portal (:3001), and workers.

Partner + developer docs (this site):

```bash
pnpm --filter @blinqx/docs dev
# http://localhost:4322
```

## Operational entrypoints

| Script / entry | Purpose |
| --- | --- |
| `apps/control-plane` CLI | Tenant provision, fleet migrations |
| `scripts/dev.mjs` | Dev orchestration |
| `scripts/check-openapi.mjs` | Live OpenAPI smoke |
| `scripts/validate-residency.mjs` | EU residency gate |
| `scripts/conformance.sh` | Conformance suite |
| `pnpm docs:openwiki` | Safe OpenWiki refresh (do **not** run bare `openwiki --update`) |

## Runbooks

Under `docs/runbooks/`: deploy, cutover, incident, restore, tenant provisioning, M365/WOPI, and docs surfaces:

- [`partner-docs-pages.md`](https://github.com/blinqx-hq/basenet-rebuild-poc/blob/main/docs/runbooks/partner-docs-pages.md) — Pages deploy + local port
- [`docs-surfaces.md`](https://github.com/blinqx-hq/basenet-rebuild-poc/blob/main/docs/runbooks/docs-surfaces.md) — OpenWiki ↔ Blume ↔ Scalar map
- [`real-tenant-fixture.md`](https://github.com/blinqx-hq/basenet-rebuild-poc/blob/main/docs/runbooks/real-tenant-fixture.md) — boot on real migrated tenant data ([guide](/developers/tenant-fixtures))

## Checks when changing ops code

- Provisioning / fleet → control-plane CLI + related runbooks
- Startup → `pnpm dev` still boots documented services
- Docs site → `pnpm --filter @blinqx/docs build` and symlink checks in `docs-surfaces.md`