Voor developers: een terminal in je draaiende app, zoals je dat op een server gewend bent. Daarmee draai je bijvoorbeeld bin/magento, wp of php artisan, of kijk je in je database. Bestanden kopieer je met dezelfde CLI, en wie liever met een programma als FileZilla werkt, kan SFTP aanzetten.
Wat je nodig hebt
- Je bent eigenaar of beheerder van de werkruimte, met tweestapsverificatie aan. Leden met een andere rol kunnen geen terminal openen.
- De Cubli-CLI met Node.js 22 of nieuwer. Zie CLI-commando’s voor inloggen en een map koppelen.
Hoe cubli ssh werkt
Er staat geen SSH-poort open en je hebt geen SSH-sleutel nodig. De CLI vraagt met je login een eenmalige toegang aan bij Cubli, en de terminal loopt daarna via Cubli naar je draaiende app.
Vanuit een map die aan je app gekoppeld is (cubli link):
npx @cubli/cli ssh
Voor een andere app: npx @cubli/cli ssh --service <id van de app>. Heb je de CLI geïnstalleerd, dan is het cubli ssh of cubli ssh --service <id>. Afsluiten doe je met exit.
In het dashboard staat het bij je app onder Instellingen, Terminal (SSH). Daar staat het commando met het juiste id om te kopiëren, en zie je wie er een terminal opende.
In je database of Redis
npx @cubli/cli db shell
Dat opent de eigen client van de database (mariadb of psql) als de gebruiker van je app, nooit als beheerder. Heeft je app meer dan één database, geef er dan een mee: --database <id>. Voor Redis opent valkey-cli. Het commando met het juiste id staat bij de database onder Terminal.
Bij Postgres start psql in een eigen tijdelijke omgeving naast je database. Dat duurt een paar seconden. Die omgeving is weg zodra je afsluit, dus ook wat je daar met \o of \copy als bestand wegschrijft. Er kunnen 5 van deze terminals tegelijk open staan per omgeving.
Bestanden kopiëren
Hiervoor heb je geen SFTP nodig: de bestanden gaan ingepakt via Cubli.
Ophalen naar je computer:
npx @cubli/cli files pull
Dit haalt de bewaarde bestanden van je app op naar de map waar je staat (bij WordPress wp-content, bij Magento de media). Een andere map in de app geef je mee, een andere plek op je computer met --to:
npx @cubli/cli files pull /var/www/html/wp-content/themes --to ./themes
Neerzetten in je app:
npx @cubli/cli files push ./wp-content
Dit zet de bestanden uit een map op je computer in de bewaarde map van je app. Een andere map in de app geef je als tweede mee. Bestanden met dezelfde naam worden vervangen, andere blijven staan. Cubli vraagt eerst of het goed is (--yes slaat die vraag over), en de bestanden krijgen de gebruiker van je app. Een upload is maximaal 2 GB.
Voor een andere app dan de gekoppelde geef je bij beide --service <id> mee.
Wat je beter niet doet op een draaiende site
Je werkt in je live site: wat je doet, merken je bezoekers meteen.
- Geen blijvende wijzigingen buiten de bewaarde bestanden. Alles buiten de bewaarde map (bij WordPress
wp-content, bij een webshop de media) is weg bij de volgende deploy. Wat moet blijven, zet je in je code. - WordPress zelf niet aanpassen. De bestanden van WordPress buiten
wp-contentkomen bij elke start opnieuw uit het image. Een wijziging daarin houdt dus geen stand. - Een database is meteen live. Wat je met
db shellverandert, geldt direct voor je site, en er is geen knop om één query terug te draaien. Twijfel je, probeer het dan eerst op staging. Ging het toch mis, dan zet je een eerder moment terug via Back-ups en terugzetten. - Niet in één keer alles vervangen.
files pushoverschrijft bestanden met dezelfde naam. Zet liever alleen de map neer die je echt wijzigt, zoals één thema of één plugin.
Een volledige kopie downloaden
Een dump van je database, of alle bewaarde bestanden van je app als één download, maak je in het dashboard, niet met de CLI of een AI-tool:
- bij de database: Database downloaden;
- bij je app onder Instellingen, Back-ups: Bestanden downloaden. Bij WordPress en bij een Magento- of Shopware-webshop kies je Back-up downloaden: bestanden en database van hetzelfde moment.
De link werkt 15 minuten. Na 24 uur is de download weg.
SFTP, voor programma’s als FileZilla
cubli files is de standaard en heeft geen SFTP nodig. Werk je liever met een SFTP-programma, dan kan de eigenaar SFTP per app aanzetten. Het staat standaard uit. Je vindt het bij apps met bewaarde bestanden, zoals WordPress.
Aanzetten:
- Open je app en ga naar Instellingen, Terminal (SSH), SFTP, en klik Wijzigen.
- Klik 7 dagen aanzetten. Na 7 dagen gaat SFTP vanzelf uit. Nog nodig? Klik Nog 7 dagen. Klaar met de klus? Klik meteen Uitzetten.
- Voeg per persoon een publieke sleutel toe, met een naam erbij: de regel uit het
.pub-bestand, bijvoorbeeldssh-ed25519 AAAA…. Nooit een privésleutel.
Verbinden:
sftp -P 4422 <id van de app>@api.cubli.io
Het juiste commando staat bij SFTP in de instellingen. De eerste keer vraagt je programma of je de server vertrouwt. De vingerafdruk van Cubli is SHA256:xGBpv/+CITyp36B9KuTH5lENIArJgV/UK3/jFmQk/1Y (ED25519).
Goed om te weten:
- Aanzetten en sleutels toevoegen kan alleen de eigenaar, in het dashboard.
- Inloggen gaat alleen met een sleutel (ed25519, ECDSA of RSA van minstens 3072 bits), nooit met een wachtwoord. Per app kunnen er 10 sleutels zijn. Een sleutel weghalen of SFTP uitzetten sluit open verbindingen meteen.
- Je komt alleen bij de bewaarde bestanden van je app (bij WordPress
wp-content), als de gebruiker van je app. Een shell of commando’s draaien kan via SFTP niet; daarvoor iscubli ssh. - Elke login staat bij de sessies van de app, met de naam bij de sleutel.
- Gaat het project naar een andere werkruimte, dan gaan de sleutels eraf en staat SFTP weer uit.
Let op: wie een van deze sleutels heeft, kan alle bestanden van je site wijzigen en verwijderen, zonder tweestapsverificatie. Geef elke persoon een eigen sleutel en deel nooit een privésleutel.
Goed om te weten
- Een terminal of SFTP-login sluit na 30 minuten zonder activiteit, en na 4 uur altijd. Draai het commando opnieuw om verder te gaan.
- Bij de app en de database zie je wie er wanneer een terminal opende, of bestanden ophaalde of neerzette. Wat er getypt wordt, bewaart Cubli niet.
- AI-tools die via de MCP-koppeling met Cubli werken, kunnen geen terminal openen.
Dank je voor je reactie.Wat miste je? Mail het naar info@cubli.io
Lees ook
Kom je er niet uit? Klik in je dashboard op Hulp, of mail info@cubli.io.





