Skip to content

Add Explore 03: put a GitHub organization under the VTC with the VGI bridge #59

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
geoffturk merged 7 commits into from
Nov 2, 2026
Merged

Add Explore 03: put a GitHub organization under the VTC with the VGI bridge #59

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
7d8eeaf
Add Explore 03: put a GitHub organization under the VTC with the VGI …
geoffturk Oct 22, 2026
932de34
Explore 03: install cnm-server from the download server
geoffturk Oct 23, 2026
a9c09df
Install cnm-server in Server Setup, and have Explore 03 only check it
geoffturk Oct 23, 2026
cc67b11
Explore 03: add an "Upgrading the bridge" section
geoffturk Nov 2, 2026
eab8769
Explore 03: the verify-trust pin changes nothing under the bridge-pos…
geoffturk Nov 2, 2026
d76234c
Explore 03: say the page is a one-off run, kept as a guide for an AI
geoffturk Nov 2, 2026
06e43fe
Explore 03: join the two top callouts into one blockquote
geoffturk Nov 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions sysop/explore/01-server-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -143,6 +143,11 @@ chmod +x vtc && mv vtc /usr/local/bin/
curl -O https://download.firstperson.dev/pnm-server/nightly/pnm
chmod +x pnm && mv pnm /usr/local/bin/

# cnm-server: the same server build of CNM, the community administrator's
# tool, used from this box in Explore 03. Same rule: not the cnm/ path.
curl -O https://download.firstperson.dev/cnm-server/nightly/cnm
chmod +x cnm && mv cnm /usr/local/bin/

curl -O https://download.firstperson.dev/mediator/nightly/mediator
chmod +x mediator && mv mediator /usr/local/bin/

Expand Down Expand Up @@ -173,6 +178,11 @@ chmod +x vtc && mv vtc /usr/local/bin/
curl -O https://download.firstperson.dev/pnm-server/latest/pnm
chmod +x pnm && mv pnm /usr/local/bin/

# cnm-server: the same server build of CNM, the community administrator's
# tool, used from this box in Explore 03. Same rule: not the cnm/ path.
curl -O https://download.firstperson.dev/cnm-server/latest/cnm
chmod +x cnm && mv cnm /usr/local/bin/

curl -O https://download.firstperson.dev/mediator/latest/mediator
chmod +x mediator && mv mediator /usr/local/bin/

Expand Down Expand Up @@ -208,8 +218,11 @@ git checkout VTI-Eucalyptus # latest tagged release, or 'git checkout nightly' f
cargo install --path vta-service --no-default-features --features "setup,config-seed,didcomm,rest,cli-synthesis"
cargo install --path vtc-service --no-default-features --features "setup,config-secret,website,admin-ui"
cargo install --path pnm-cli --no-default-features --features "config-session,tsp"
cargo install --path cnm-cli --no-default-features --features "config-session"
```

`pnm` and `cnm` are built with `config-session` in place of their default `keyring` feature, so their sessions go to a plaintext file instead of an OS keyring, which a headless host has no access to. `cnm-cli` has no `tsp` feature to add back; its TSP comes with `vtc-client`.

#### Mediator

```bash
Expand Down
4 changes: 4 additions & 0 deletions sysop/explore/02-walkthrough.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -875,6 +875,10 @@ Navigate to `https://vtc.yourdomain.com/admin` and sign in with your new passkey

You now have access to the VTC Admin Dashboard and can set up access for the community manager(s) of the VTC.

## Next

Put a GitHub organization under the community: [03 — Verifiable Git Infrastructure](03-verifiable-git-infrastructure.md).

## Known Issues / Edge Cases

### DID Enrollment URL is single-use
Expand Down
Loading