diff --git a/.env.example b/.env.example index dae0f1370..9e9ed5a79 100644 --- a/.env.example +++ b/.env.example @@ -29,7 +29,8 @@ DX_SYNC_INTERVAL= # serves it at /api/pb, admin UI /api/pb/_/, data in .pb/dev (gitignored). Nothing leaves this computer. # Set to a PocketBase root (e.g. https:///pb) to use a shared team one instead. DX_PB_URL= -# The local PocketBase's port. Empty = 8090 (change it only if the log says the port is in use). +# The local PocketBase's port. Empty = 8090 (change it only if the log says the port is in use, then restart +# `bun run dev`: settings are read when it starts). DX_PB_PORT= # ── Rudder, voice to text (backend/rudder-engine) ──────────────────────────────────────────────── diff --git a/README.md b/README.md index 8ab836e8c..596b287d1 100644 --- a/README.md +++ b/README.md @@ -712,7 +712,7 @@ bun run dev # → open the URL Vite prints: that page is the No build needed first — the built maps are already in the repo. `bun run dev` also starts a local PocketBase on port 8090 for the plugins that use a backend; it is downloaded on the first run (if 8090 is -taken, set `DX_PB_PORT` in `.env.local`). To start a +taken, set `DX_PB_PORT` to any free port in `.env.local` and restart `bun run dev`). To start a plugin, copy `plugin-designs/template-bundle/` to `plugin-designs//`; the studio finds it automatically. Then rename it as its own `README.md` says. Each plugin also has its own page while `bun run dev` runs, at `/__leaf//` (for example `/__leaf/all-people-groups/all-people-groups`), and the diff --git a/documentation/HOWTO-join-the-table.md b/documentation/HOWTO-join-the-table.md index 38f9295d5..635327435 100644 --- a/documentation/HOWTO-join-the-table.md +++ b/documentation/HOWTO-join-the-table.md @@ -169,7 +169,8 @@ You sign in with the same team account you use for everything else — there is whoever set up your team for the address. Leave the line out and you stay on your own local one, which is the right place to be while you are finding your feet. -The only other thing here is `DX_PB_PORT`, which you set only if the log says port 8090 is already in use. +The only other thing here is `DX_PB_PORT`, which you set only if the log says port 8090 is already in use: pick +any free port, then restart `bun run dev`, which reads these settings when it starts. > **New collections start locked.** Your plugin's data is not readable until a migration opens it — > deliberately, so nothing is public by accident. That migration is a commit like any other.