Naar de inhoud

Problemen oplossen

Een foutmelding of iets dat niet werkt? Zoek je probleem op en volg de oplossing.

Zoek hieronder wat je ziet. Klik op het probleem voor de oplossing.

Wat je ziet Oplossing
Online zetten mislukt met een bouwfout Fout bij het bouwen
Online zetten mislukt bij het opstarten Website start niet op
"Deze website wordt klaargezet" op je adres Website wordt klaargezet
De browser opent niet om in te loggen Inloggen via de browser
git of node wordt niet gevonden Git of Node.js niet gevonden
npx wordt niet gevonden npx niet gevonden
EBADENGINE of "Unsupported engine" Node.js te oud
claude wordt niet gevonden Claude Code niet gevonden
Rode melding: "running scripts is disabled" (Windows) Scripts uitgeschakeld
"Permission denied" of "Toegang geweigerd" Geen toestemming
"Er zijn … elders wijzigingen gemaakt" Wijzigingen ergens anders
Je wijziging staat niet online Oude versie zichtbaar
Je account wacht nog op goedkeuring Account niet goedgekeurd
Je eigen domeinnaam werkt niet Domeinnaam koppelen

#Fout bij het bouwen

Je AI meldt dat het bouwen is mislukt. Er zit een fout in de code die je AI heeft geschreven. Je vorige versie staat nog gewoon online.

  1. Zeg tegen je AI: "Het online zetten is mislukt. Lees de foutmelding, los het op en probeer het opnieuw."
  2. Lukt het niet na een paar pogingen? Laat je AI eerst het voorbeeld starten (npm run build geeft vaak dezelfde fout op je eigen computer), of draai de laatste wijziging terug.
  3. In het dashboard zie je bij Publicaties de uitleg en het volledige bouwlogboek.

#Website start niet op

Het bouwen lukte, maar je website antwoordde niet binnen 60 seconden. Vaak ontbreekt er een instelling, of loopt de website vast bij het opstarten.

  • Heb je net een instelling toegevoegd of veranderd? Controleer de naam en waarde bij instellingen en geheimen.
  • Vraag je AI: "De website start niet op na het online zetten. Bekijk het bouwlogboek en het logboek en los het op."

#Website wordt klaargezet

Je ziet op je webadres een pagina van Switchboard: "Deze website wordt klaargezet" of "Deze website is gepauzeerd". Dat betekent dat er (nog) geen werkende versie live staat.

  • Net aangemaakt? De eerste keer online zetten duurt ongeveer twee minuten. Ververs de pagina straks.
  • Staat er "Er is een probleem" of "Werkt op dit moment niet"? De eerste versie is niet gelukt. Zie fout bij het bouwen.
  • Staat er "Staat uit" of "Gestopt"? Klik in het dashboard op Starten.
  • Gepauzeerd? Je account is gepauzeerd. Neem contact op.
  • Alleen op je eigen domeinnaam? Dan is je domeinnaam nog niet helemaal gekoppeld. Zie domeinnaam koppelen.

#Inloggen via de browser

Bij init of login hoort je browser te openen met een pagina om de koppeling goed te keuren.

  • Opent er niets? In je terminal staat een adres (iets met /app/cli?code=) en een code zoals KDTM-WQPL. Kopieer het adres naar je browser en klik op Toegang geven.
  • "Code verlopen"? Een code is 10 minuten geldig. Start de opdracht opnieuw.
  • Je ziet een inlogscherm? Log eerst in bij Switchboard; daarna kom je vanzelf bij de goedkeuring.
  • Werk je op een computer zonder browser (bijvoorbeeld via een server)? Open het adres dan op je telefoon of een andere computer. Dat werkt ook.

#Git of Node.js niet gevonden

Je ziet iets als git: command not found, 'node' is not recognized of De term 'git' wordt niet herkend.

  1. Sluit je terminal en open een nieuwe. Na het installeren kent een open terminal het nieuwe programma nog niet.
  2. Controleer met git --version en node --version.
  3. Nog steeds niet? Installeer ze opnieuw volgens Node.js en Git installeren.
  4. Op Windows kan ook een herstart van je computer helpen.

#npx niet gevonden

npx hoort bij Node.js. Zie je npx: command not found of 'npx' is not recognized?

  1. Sluit je terminal en open een nieuwe.
  2. Controleer of Node.js er is: node --version. Geen versienummer? Installeer Node.js.
  3. Is het versienummer lager dan 24? Zie Node.js te oud.

#Node.js te oud

Bij het klaarzetten van je website (npm run setup of npm install) zie je EBADENGINE, Unsupported engine of required: { node: '>=24' }. Je website heeft Node.js 24 of nieuwer nodig, en op je computer staat een oudere versie. Je website online zetten lukt wel, maar het voorbeeld op je eigen computer niet.

  1. Controleer je versie met node --version.
  2. Lager dan v24? Installeer Node.js opnieuw volgens Node.js en Git installeren. Op Linux staat daar hoe je versie 24 krijgt; de versie van je systeem zelf is vaak te oud.
  3. Sluit je terminal, open een nieuwe en zeg tegen je AI: "Node.js is bijgewerkt. Voer npm run setup opnieuw uit."

#Claude Code niet gevonden

Zie je claude: command not found of 'claude' is not recognized?

  1. Sluit je terminal en open een nieuwe.
  2. Installeer Claude Code opnieuw volgens de handleiding.
  3. Werkt het daarna nog niet? Op een Mac of Linux helpt het vaak om deze opdracht te plakken en daarna een nieuwe terminal te openen:
Terminal
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

#Scripts uitgeschakeld (Windows)

In PowerShell zie je een rode melding zoals:

npx : File C:\Program Files\nodejs\npx.ps1 cannot be loaded because running scripts is disabled on this system.

Windows blokkeert dan programma's zoals npx. Sta ze toe voor jouw gebruiker met deze opdracht:

PowerShell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Typ J (of Y) en druk op Enter als erom gevraagd wordt. Probeer het daarna opnieuw.

#Geen toestemming

Je ziet Permission denied, EACCES of Toegang geweigerd.

  • Bij npm install -g op Linux of een Mac? npm mag dan niet schrijven in de systeemmap. Gebruik geen sudo, maar laat npm programma's voortaan in je eigen map zetten. Plak deze twee regels één keer, sluit je terminal, open een nieuwe en probeer het opnieuw:

    Terminal
    npm config set prefix ~/.local
    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

    Voor de Switchboard-opdrachten zelf hoef je niets te installeren: npx -y @switchboard-host/cli@latest werkt altijd.

  • Bij het online zetten ("authentication failed" of "403")? Je koppeling is ingetrokken of verlopen. Log opnieuw in met npx -y @switchboard-host/cli@latest login.

  • "Account not approved"? Zie account niet goedgekeurd.

  • Op Windows, in een map als C:\Program Files? Werk liever in je eigen map, zoals Documenten.

#Wijzigingen ergens anders

Je ziet een melding als "Er zijn net elders wijzigingen gemaakt." of "Er zijn intussen elders wijzigingen gemaakt (bijvoorbeeld op een andere computer of op GitHub)." Er staat bij Switchboard een nieuwere versie dan op je computer, bijvoorbeeld omdat je op een andere computer of op GitHub iets hebt aangepast. Er gaat niets verloren: je wijzigingen staan nog op je computer. Zeg tegen je AI: "Haal de nieuwste versie op, voeg de wijzigingen samen en zet het opnieuw online." Zie werken met GitHub.

#Oude versie zichtbaar

Je hebt iets online gezet, maar je ziet het niet.

  1. Ververs de pagina zonder geheugen: Ctrl+F5 (Mac: ⌘ Cmd+Shift+R).
  2. Kijk in het dashboard bij Publicaties of de laatste versie op Live staat.
  3. Mislukt? Zie fout bij het bouwen.

#Account niet goedgekeurd

Zolang je account wacht op goedkeuring, kun je inloggen en de handleiding lezen, maar nog geen websites maken of online zetten. We keuren je account goed na de kennismaking. Duurt het lang? Neem contact op.

#Nog steeds vast?

Voer deze opdracht uit in de map van je website. Hij controleert alles en vertelt wat er mis is:

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

Kom je er niet uit, neem contact op. Stuur de melding mee die je ziet.

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.