Je eerste deploy met de CLI

Met de Cubli-CLI zet je de map waarin je werkt online, zonder Dockerfile en zonder GitHub. Het duurt een paar minuten.

Wat je nodig hebt

• Node.js 20 of nieuwer op je computer. Daarmee werkt npx.
• Een Cubli-account en een project met een pakket. Maak het project in het dashboard: Projecten, Nieuw project, Verder: kies een pakket. Zie Je eerste site online zetten.

1. Log in

npx @cubli/cli login

Je browser opent. Controleer dat hij dezelfde code toont als je terminal, kies de werkruimte en klik Toegang geven. De CLI werkt daarna alleen in die werkruimte. Je login wordt bewaard in ~/.config/cubli/cli.json.

2. Koppel je map aan een project

Zoek het id van je project:

npx @cubli/cli projects

Koppel de map waarin je staat aan dat project:

npx @cubli/cli link --project <id>

Het commando staat ook kant-en-klaar in het dashboard, in een leeg project onder Of vanuit de map van je site of app.

link maakt in het project een service met de naam web (of gebruikt die als hij al bestaat) en schrijft een bestand .cubli.json in je map. Gebruikt je map git, dan zet de CLI .cubli.json in je .gitignore. Luistert je app op een andere poort dan 8080, geef die dan mee met --port. Een andere naam voor de service geef je met --service.

3. Zet hem online

npx @cubli/cli up

De CLI pakt je map in, uploadt hem, bouwt hem bij Cubli en laat de bouwlog live zien. Is hij klaar, dan zie je het adres:

✓ Live at https://bakkerij-jansen-a9ixqd.cubli.app (48 s)

Daarna is het steeds alleen npx @cubli/cli up. Met -m "nieuw menu" geef je een korte notitie mee, die je terugziet bij de versies in het dashboard.

Als het misgaat

Mislukt het bouwen of starten, dan zie je de reden en blijft de vorige versie gewoon online. Pas je code aan en draai up opnieuw. Wat er bij het bouwen gebeurt, lees je in Hoe Cubli je code bouwt.

Sneller typen

Installeer de CLI één keer, dan heet het commando gewoon cubli:

npm install -g @cubli/cli
cubli up

Verder

• Alle commando’s: CLI-commando’s.
• Je AI-tool laten deployen: MCP in Claude Code, Codex en Cursor.
• Liever bij elke push: Deployen vanuit GitHub.
• Je eigen domein: Je eigen domein koppelen.