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.
- Zeg tegen je AI: "Het online zetten is mislukt. Lees de foutmelding, los het op en probeer het opnieuw."
- Lukt het niet na een paar pogingen? Laat je AI eerst het voorbeeld starten (
npm run buildgeeft vaak dezelfde fout op je eigen computer), of draai de laatste wijziging terug. - 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 zoalsKDTM-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.
- Sluit je terminal en open een nieuwe. Na het installeren kent een open terminal het nieuwe programma nog niet.
- Controleer met
git --versionennode --version. - Nog steeds niet? Installeer ze opnieuw volgens Node.js en Git installeren.
- 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?
- Sluit je terminal en open een nieuwe.
- Controleer of Node.js er is:
node --version. Geen versienummer? Installeer Node.js. - 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.
- Controleer je versie met
node --version. - 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. - Sluit je terminal, open een nieuwe en zeg tegen je AI: "Node.js is bijgewerkt. Voer
npm run setupopnieuw uit."
#Claude Code niet gevonden
Zie je claude: command not found of 'claude' is not recognized?
- Sluit je terminal en open een nieuwe.
- Installeer Claude Code opnieuw volgens de handleiding.
- 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:
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:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSignedTyp 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 -gop Linux of een Mac? npm mag dan niet schrijven in de systeemmap. Gebruik geensudo, 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:npm config set prefix ~/.local echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcVoor de Switchboard-opdrachten zelf hoef je niets te installeren:
npx -y @switchboard-host/cli@latestwerkt 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.
- Ververs de pagina zonder geheugen: Ctrl+F5 (Mac: ⌘ Cmd+Shift+R).
- Kijk in het dashboard bij Publicaties of de laatste versie op Live staat.
- 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:
npx -y @switchboard-host/cli@latest doctorKom je er niet uit, neem contact op. Stuur de melding mee die je ziet.