Naar de inhoud

Alle opdrachten (CLI)

Overzicht van elke Switchboard-opdracht voor de terminal, met voorbeelden.

De Switchboard-opdrachten (de CLI, command line interface) gebruik je in de terminal. Meestal voert je AI ze voor je uit, maar je kunt ze ook zelf gebruiken.

Je hoeft niets te installeren. Elke opdracht begint met npx -y @switchboard-host/cli@latest, gevolgd door wat je wilt doen:

Terminal
npx -y @switchboard-host/cli@latest status

Behalve bij login, init en apps werken de opdrachten met de website van de map waarin je staat. Met --app naam kies je een andere website.

#Aan de slag

Opdracht Wat het doet
login Inloggen via je browser (je keurt de koppeling goed op een pagina van Switchboard).
logout Uitloggen op deze computer.
whoami Laat zien met welk account je bent ingelogd.
apps Je websites.
init <naam> [map] Haalt een website naar deze computer en zet alles klaar: inloggen, bestanden ophalen, onderdelen installeren.
link [naam] Koppelt de map waarin je staat aan een website (als je de bestanden al hebt).
Terminal
npx -y @switchboard-host/cli@latest init bakkerij-jansen
npx -y @switchboard-host/cli@latest init bakkerij-jansen website-bakkerij

#Online zetten

Opdracht Wat het doet
deploy Slaat je wijzigingen op en zet ze online. Volgt het bouwen en geeft het adres of een uitleg bij een fout.
deploy -m "tekst" Hetzelfde, met een beschrijving van wat je hebt veranderd.
deploy --no-follow Start het online zetten zonder te wachten op het resultaat.
status Hoe het met je website gaat.
logs Wat je website nu in het logboek schrijft. -f blijft meekijken; --role backend toont alleen de aparte backend.
rollback [nummer] Zet een eerdere versie terug online (zonder nummer: de vorige).
restart Start je website opnieuw op, bijvoorbeeld na het wijzigen van een instelling.
open Opent je website in de browser. Met --dashboard open je het dashboard.
Terminal
npx -y @switchboard-host/cli@latest deploy -m "Prijzen bijgewerkt"
npx -y @switchboard-host/cli@latest logs -f
npx -y @switchboard-host/cli@latest rollback 12

#Instellingen

Opdracht Wat het doet
env list Je instellingen en geheimen (geheimen zie je niet).
env set NAAM WAARDE Slaat een instelling op. Met --secret wordt het een geheim. Zonder waarde vraagt hij erom.
env unset NAAM Verwijdert een instelling.
domains Je domeinnamen en of ze al werken.
Terminal
npx -y @switchboard-host/cli@latest env set CONTACT_EMAIL info@bakkerijjansen.nl
npx -y @switchboard-host/cli@latest env set MOLLIE_API_KEY --secret

Zie ook instellingen en geheimen.

#Hulp

Opdracht Wat het doet
doctor Controleert of alles klaarstaat: Node.js, Git, inloggen en de koppeling. Met --fix lost hij wat hij kan zelf op.
mcp Start de MCP-koppeling voor je AI-hulpje. Zie MCP.
git-credential Wordt door Git gebruikt om in te loggen. Niet zelf gebruiken.
--help Laat alle opdrachten zien.
Terminal
npx -y @switchboard-host/cli@latest doctor

#Opties voor elke opdracht

Optie Betekenis
--app <naam> Kies de website (standaard: die van deze map).
--lang nl of --lang en Taal van de meldingen.
--json Antwoord voor programma's en AI-hulpjes.
--verbose Meer details, bij deploy het hele bouwlogboek.

#Voor gevorderden

  • De inloggegevens staan in een bestand op je computer: op Windows in %APPDATA%\switchboard\config.json, op een Mac in ~/Library/Application Support/switchboard/config.json en op Linux in ~/.config/switchboard/config.json.
  • In elke websitemap staat .switchboard/app.json met de naam van de website. Daar staan geen geheimen in.
  • SWITCHBOARD_TOKEN en SWITCHBOARD_API_URL overschrijven de inloggegevens, bijvoorbeeld voor automatisering.
  • Afsluitcodes: 0 gelukt, 1 fout, 2 online zetten mislukt.

Had je hier iets aan?

Handleiding

Zoeken in de handleiding

Typ een woord of een vraag. Tip: druk op Ctrl K om dit venster overal te openen.