@robiznl/cli

Zet je project live op Robiz-hosting — koppelen, deployen en beheren vanaf de commandline. Bedoeld om door je coding agent gedraaid te worden, maar prima zelf te gebruiken.

Je hoeft niets te installeren:

npx @robiznl/cli link ROBIZ-XXXX-XXXX
npx @robiznl/cli deploy

Aan de slag

1. Maak in je Robiz-paneel een app aan met Deploy via je coding agent.
2. Kopieer de koppelcode die je krijgt.
3. Draai npx @robiznl/cli link <code> in de map van je project.
4. Draai npx @robiznl/cli deploy.

Robiz bouwt je project (met je eigen Dockerfile als je die hebt, anders bepaalt Nixpacks het zelf), rolt het uit en meldt de URL zodra de container daadwerkelijk draait.

Commando's

| Commando | Wat het doet | | ------------------------------------ | -------------------------------------------------------------------------------- | | login | Logt deze machine in op je Robiz-account, zonder koppelcode | | logout | Logt uit en trekt het token in | | link <code> | Koppelt deze map aan een app in je paneel | | deploy | Uploadt je code, bouwt hem en zet hem live | | run "<commando>" | Draait één commando in je container en geeft stdout, stderr en de exitcode terug | | shell | Opent een interactieve sessie in je container | | logs | Toont de logs van je draaiende app | | env pull \| push \| set KEY=waarde | Beheert je omgevingsvariabelen | | status | Toont de staat van je app | | apps | Toont al je apps |

Elk commando accepteert --json voor machineleesbare uitvoer. deploy en run eindigen met een exitcode ≠ 0 als er iets misgaat, met de reden in de uitvoer — zodat een agent zelf kan zien wat er stuk is en het kan repareren.

Inloggen zonder koppelcode

Wil je bij al je apps kunnen zonder eerst een map te koppelen, log dan in:

npx @robiznl/cli login

Je krijgt een link en een code; goedkeuren doe je ingelogd in je paneel. Daarna werken run, shell, logs, env, status en apps overal: kies een app met --app <id>, of laat de CLI er interactief één vragen. In een gekoppelde projectmap wint de koppeling van die map. Ingelogde machines zie je (en verwijder je) in je paneel onder Instellingen → Beveiliging.

deploy blijft bewust bij een gekoppelde map horen: uploaden doe je vanuit de map zelf.

Je app moet luisteren op $PORT

Robiz geeft je container een PORT-variabele mee; laat je app daarnaar luisteren. Vrijwel elk framework doet dit al. Kan het echt niet, zet dan de poort in een robiz.json in je projectmap:

{ "port": 8000 }

Wat er wordt geüpload

Alles in je projectmap, behalve node_modules, .git, vendor, __pycache__, .venv en .robiz — plus alles wat in je .gitignore staat. Wil je meer uitsluiten, maak dan een .robizignore met dezelfde opzet.

.env-bestanden gaan nooit mee. Secrets horen niet in een image die op onze registry blijft staan. Gebruik npx @robiznl/cli env push om ze veilig naar je app te sturen.

Waar dingen worden opgeslagen

• .robiz/config.json in je project: welke app deze map is. Veilig om te committen.
• ~/.robiz/credentials.json: je toegangstoken, alleen leesbaar voor jezelf. Niet committen.

Een andere Robiz-omgeving

Standaard praat de CLI met https://cp.robiz.nl. Wijs hem ergens anders heen met ROBIZ_HOST:

ROBIZ_HOST=https://cp.example.nl npx @robiznl/cli status