Skip to content
Board

For Developers

Your admin gives you a zip file. Everything else is automatic.

Connect

Section titled “Connect”
  1. Unzip the folder and double-click Setup Board (.command on Mac, .cmd on Windows)
  2. VS Code imports your board pass automatically. For SSH-key boards, you’ll be asked for a passphrase — enter the one your admin gave you. Entra ID boards need no passphrase.
  3. If your board uses Entra ID auth, ensure you have Azure CLI installed and run az login in your terminal first
  4. Your Board Pass card appears — click Connect Now

You’re coding on a cloud VM. VS Code’s file explorer, terminal, and extensions all run remotely.

First-time setup

Section titled “First-time setup”

On first connect, you’ll be prompted to run a short setup: your name for Git and optionally GitHub authentication (for Copilot). After that, your projects are at ~/projects/ with everything already running.

Daily workflow

Section titled “Daily workflow”

Start your board (if stopped): click the Board status bar item in VS Code, or ask your admin.

Check health:

Terminal window
check

See available commands:

Terminal window
board-help

Port forwarding

Section titled “Port forwarding”

VS Code automatically forwards every listening port from your VM to localhost. When a service starts (API, database, Langfuse, etc.), it appears in the Ports panel — open it with Ctrl+Shift+P → Ports: Focus on Ports View. Click the globe icon to open any port in your browser.

Not using VS Code? Run forward-ports on the VM to get an SSH command that tunnels all listening ports at once.

Browser tools

Section titled “Browser tools”

Your board includes two browser-based admin tools (VS Code forwards the ports automatically when connected):

  • Cockpit (http://localhost:9091) — system monitoring, logs, file browser, and terminal. Log in with devuser / board.
  • Portainer (https://localhost:9444) — Docker container management, logs, and restart services. The admin password is unique per VM — run cat ~/.portainer-password to see it. Portainer uses a self-signed certificate, so accept the browser warning on first visit.

Open them from the command palette: Board: Open Cockpit or Board: Open Portainer.

Auto-shutdown

Section titled “Auto-shutdown”

Boards stop at 7 PM daily to save costs. Your files, Docker volumes, and git state all persist — just reconnect tomorrow.