Typ minstens twee letters om elke pagina van de docs te doorzoeken.

↑ ↓ om te navigeren ↵ om te openen esc om te sluiten

rdev gebruiken

Je laptop verbinden

Je laptop is de editor en de browser. De code, de services en de agents blijven op je server.

Je eigen tailnet

Je laptop en je server praten via een privé-Tailscale-netwerk dat bij je Tailscale-account hoort. rdev voegt zich er nooit bij. Het installatieprogramma verbindt je server met een sleutel uit je account en de laptopapp verbindt je laptop.

Bestandssynchronisatie

rdev houdt je projectbestanden in beide richtingen gesynchroniseerd tussen je laptop en je server. Mappen die niet mee hoeven te reizen, zoals node_modules, vendor en buildoutput, worden vanaf het begin genegeerd.

Je kiest in je paneel wat wordt gesynchroniseerd, onder Dashboard > je server > Instellingen:

  • Synchroniseren naar laptops: zet het uit om volledig remote te werken. Er wordt niets naar de laptop gekopieerd; je editor opent projecten via SSH (ssh rdev, VS Code of Cursor Remote-SSH, PhpStorm Gateway). Sites en .dev.test blijven werken.
  • Projecten op laptops: vink een project uit om het alleen op de server te houden. Een kopie die al op je laptop staat, blijft met rust gelaten, dus verwijder haar als je haar niet meer nodig hebt. Als een project later weer synchroniseert, wordt de oudere laptopkopie eerst naar ~/Code-rdev-old/ verplaatst en komt de kopie van de server binnen.
  • Nooit gesynchroniseerd: de standaarduitsluitingen, die je elk kunt uitschakelen, plus je eigen patronen in een .gitignore-achtige syntaxis.

Laptops passen de nieuwe regels binnen een paar minuten toe. Voer rdev laptop sync uit om ze meteen toe te passen.

Editors en de browser

Gebruik de editor die je al kent, zoals VS Code of PhpStorm, op de gesynchroniseerde bestanden. Open je sites in je gebruikelijke browser op https://<name>.dev.test; de laptopapp stelt naamresolutie en een vertrouwd certificaat voor deze adressen in.

Bestanden delen

Een terminal op je server kan geen bestand plakken, dus rdev geeft je agent een gedeelde map. Alles in ~/rdev-share op je laptop wordt binnen enkele seconden gekopieerd naar ~/Share/<laptop name> op de server, ook als bestandssynchronisatie uit staat; elke laptop heeft daar een eigen map, zodat meerdere laptops tegelijk kunnen delen. Vraag je agent om "naar de laatste schermafbeelding te kijken" of "het bestand te openen dat ik net stuurde" en hij opent het nieuwste. Elk soort bestand werkt: afbeeldingen, pdf's, logs, exports.

  • Klembord versturen in de app (ook in het menubalk- of systeemvakpictogram) verstuurt de bestanden die je in Finder, Verkenner of je bestandsbeheerder hebt gekopieerd, of anders de afbeelding op je klembord. Het wacht tot ze de server bereiken en zet hun serverpaden op je klembord; plak die in de agent. In een terminal: rdev laptop share send, of rdev laptop share send <files>.
  • Sleep bestanden naar het app-venster om ze op dezelfde manier te versturen.
  • De andere kant op: bestanden die je agent op de server in ~/Share/<laptop name>/out zet, komen aan in ~/rdev-share/from-server op je laptop. Vraag hem om "het rapport in out te zetten".
  • Hier macOS-schermafbeeldingen opslaan laat Shift-Command-3, 4 en 5 opslaan in ~/rdev-share (rdev laptop share macos). Schermafbeeldingsapps zoals Shottr of CleanShot kunnen daar ook opslaan.
  • Bestanden worden na 7 dagen aan beide kanten verwijderd; wijzig dit onder Bestanden bewaren (dagen) in de app of met rdev laptop share keep <days> (0 bewaart ze). Bestanden in een map keep worden nooit verwijderd.
  • Bestanden boven 500 MB worden niet verstuurd; verplaats die met scp of rsync. Alles gaat rechtstreeks naar je server en loopt nooit via rdev.cloud. Zet delen uit met de schakelaar in de app of rdev laptop share off.

Vóór 1.2.0 was dit de map voor schermafbeeldingen: ~/rdev-shots verhuist vanzelf naar ~/rdev-share en ~/Shots naar ~/Share, en ~/Shots blijft als link werken.

Ondersteunde laptops

De laptopapp en rdev laptop draaien op macOS (Apple silicon en Intel), Linux (x64 en ARM64) en Windows 10 en 11 (x64 en ARM64); haal de app op de downloadpagina. Op Linux kun je haar ook met één opdracht installeren, die op Debian en Ubuntu de .deb neemt, op Fedora de .rpm en elders de AppImage, bijvoorbeeld op Arch en CachyOS: curl -fsSL https://rdev.cloud/install | sh -s -- app. De AppImage komt in ~/.local/bin en verschijnt in je toepassingenmenu; de app laat dat item naar het bestand wijzen als je het verplaatst (1.4.4 of nieuwer). Als je de .deb zelf downloadt, installeer hem dan vanuit /tmp (sudo apt install /tmp/rdev-linux-arm64.deb, of -x64); vanuit je thuismap werkt apt ook, maar meldt dat de sandbox-gebruiker het bestand niet kan lezen. Op Linux stuurt rdev *.dev.test via systemd-resolved naar je server, wat de meeste distributies gebruiken. Als het uit staat of gemaskeerd is, zoals bij sommige images van virtuele machines, zegt rdev laptop connect dat en toont hoe je het inschakelt: sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved, daarna sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf, en verbind opnieuw. Als NetworkManager naast een draaiende systemd-resolved een eigen /etc/resolv.conf bijhoudt (Tailscale meldt dan dat ze "wired together incorrectly" zijn), bereiken opzoekingen de route van rdev nooit; rdev laptop connect en rdev laptop status zeggen dat (1.4.4 of nieuwer), en dezelfde ln -sf-opdracht verhelpt het. rdev voegt zijn certificaat toe aan de vertrouwde certificaten van het systeem op Debian, Ubuntu, Fedora, openSUSE, Arch en CachyOS; vóór 1.4.4 bleef de verbinding op Arch en CachyOS daar steken.

Stap voor stap verbinden

  1. Installeer Tailscale op je laptop en log in met hetzelfde Tailscale-account als je server. Op Linux kun je dit overslaan: als Tailscale ontbreekt, installeert rdev laptop connect het uit de officiële repository van Tailscale en start de aanmelding, die je in je browser afrondt.
  2. Installeer rdev op je laptop en verbind hem. Voer dit uit in een terminal als jezelf en voer je laptopwachtwoord in als erom wordt gevraagd; het is nodig om rdev te installeren, het certificaat te vertrouwen en naamresolutie in te stellen:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop

Het installeert de opdracht rdev en voert rdev laptop connect uit, die je server op je tailnet vindt, een rdev-item aan je SSH-configuratie toevoegt, het certificaat van je omgeving vertrouwt, *.dev.test naar je server stuurt en je map ~/Code begint te synchroniseren met ~/Code op de server.

Je hoeft eerst niets anders te installeren. Als de synchronisatietool ontbreekt, installeert rdev een vastgepinde, met checksum geverifieerde kopie in ~/.local/share/rdev/bin; een die je al hebt wordt gebruikt zoals hij is. Op Linux installeert het ook de klembordtools voor schermafbeeldingen (wl-clipboard, xclip) en certutil, dat het certificaat in Chrome zet, met je pakketbeheerder, onder dezelfde wachtwoordvraag. Als je de server bij de installatie een andere naam gaf, voeg dan --server <name> toe; om een andere map te synchroniseren voeg je --code-dir <folder> toe. Voer rdev laptop connect opnieuw uit wanneer je de installatie opnieuw wilt doen.

Voordat rdev laptop connect om je wachtwoord vraagt, controleert het de map die het gaat synchroniseren. Het stopt en stelt --code-dir <map> voor als een andere synchronisatiesessie die map of een bovenliggende map al synchroniseert (ook met rdev synchroniseren kopieert alles tussen drie machines); start het met --force of kies Toch synchroniseren in de app om hem toch te synchroniseren. Een map van meer dan 5 GB verbindt ook, met een melding dat de eerste synchronisatie even duurt (rdev 1.1.10 of nieuwer; eerder stopte het).

Op een Mac die dev.test al ergens anders heen stuurt, bijvoorbeeld naar een andere ontwikkelserver, zet rdev die instelling opzij en zet haar terug wanneer je de verbinding verbreekt of rdev verwijdert.

Op Windows is de curl-opdracht hierboven niet van toepassing: installeer de app vanaf de downloadpagina en verbind vanuit de app. Vanaf laptopapp 1.4.2 installeert de app ook de opdracht rdev in %USERPROFILE%\.local\share\rdev\bin en voegt die map toe aan je PATH; open een nieuwe terminal om hem te gebruiken. Er zijn geen beheerdersrechten voor nodig en hij wordt samen met de app bijgewerkt.

Als de app Check connection blijft tonen terwijl bestanden synchroniseren en rdev laptop status *.dev.test resolves to …, not the server zegt, kijk dan op de pagina DNS van de Tailscale-beheerconsole. Een split-DNS-item voor dev.test dat naar een andere machine wijst, zoals een oude server, gaat op Windows voor op de instelling van rdev. Verwijder het, of laat het naar je server wijzen.

Controleer de verbinding op elk moment met rdev laptop status. rdev laptop disconnect stopt de synchronisatie en verwijdert de instellingen; je bestanden blijven aan beide kanten staan.

rdev van je laptop verwijderen

rdev laptop uninstall

Het verbreekt de verbinding, stopt met het vertrouwen van het certificaat van je omgeving en verwijdert de opdracht rdev, zijn instellingen en de tools die het installeerde. Je gesynchroniseerde map en ~/rdev-share blijven staan. De synchronisatietool die rdev installeerde blijft ook staan zolang andere synchronisatiesessies hem nog gebruiken. Het vraagt één keer om je laptopwachtwoord en vereist rdev 0.2.0-beta.21 of nieuwer.

Je laptop moet op de server kunnen inloggen: het installatieprogramma kopieert de SSH-sleutels die bij de installatie op de server konden inloggen. Om een andere laptop toe te voegen, voeg je zijn openbare sleutel toe op de pagina van je server in het paneel onder SSH-sleutels (één per regel, dus meerdere computers tegelijk; als je er één toevoegt, kun je hem een naam geven zoals Werklaptop, anders wordt de naam aan het eind van de sleutel getoond); de server laat hem binnen enkele seconden toe. Dat vereist rdev 0.2.0-beta.33 of nieuwer; daarvoor zet je de sleutel in /opt/rdev/home/.ssh/authorized_keys op de server. Als rdev laptop connect zegt dat het niet kan inloggen, ontbreekt dit.

Eenmaal verbonden open je met ssh rdev een terminal op de server en start je daar je agent; open je sites in de browser op https://<folder>.dev.test. rdev open <project> opent een terminal op de server direct in de map van een project, in je blijvende sessie; zonder naam toont het de projecten (rdev 1.1.11 of nieuwer).

De Mac-app

Klik je liever dan dat je typt? Download de rdev-app voor Mac (Apple silicon en Intel, ondertekend en genotariseerd door Apple), sleep haar naar Programma's en open haar. Ze toont of je laptop verbonden is, verbindt en verbreekt met één knop en opent een terminal op je server. Ze doet dezelfde installatie als rdev laptop connect, dus je hebt Tailscale nodig (stap 1) maar niet de opdracht; de app installeert de synchronisatietool zelf. Voor het verbinden kun je de map wijzigen waarin je projecten worden gesynchroniseerd (standaard ~/Code), de variant van de app van --code-dir.

De eerste keer dat je de app opent, begeleidt hij je stap voor stap, en de tabbladen openen pas als elke stap gelukt is: log in met je rdev-account, controleer dat Tailscale geïnstalleerd en ingelogd is, kies je server uit je account, laat deze laptop binnen (de app voegt zijn SSH-sleutel zelf aan de server toe en maakt er een als hij er geen heeft), kies met Bladeren… de map waarin je projecten synchroniseren, en verbind. Later stelt Server wisselen op het tabblad Sites de laptop opnieuw in voor een andere server. Is de server van de laptop weg, onbereikbaar of niet meer in je account, dan meldt de app dat en biedt Opnieuw instellen aan. In beide gevallen blijven je bestanden waar ze zijn. Is het commando rdev ouder dan de app, dan toont About Uitvoeren in Terminal, dat je terminal opent met het updatecommando.

De app heeft zeven tabbladen:

  • Sites: je projecten als https://<name>.dev.test-links, een terminal op de server en je gedeelde bestanden. Elke site heeft Open in Terminal, dat een terminal opent in de map van dat project op de server. Het tabblad Sites heeft ook knoppen Mail en Dumps die je opgevangen e-mail en dumppagina's openen. Er is ook een knop Web terminal die de webterminal opent. Er is ook een knop Errors die de foutopsporing opent.
  • Synchronisatie: dezelfde instellingen als in je paneel (synchronisatie aan of uit, projecten op deze laptop, uitsluitingen). Opslaan past ze meteen toe op deze laptop.
  • Env: de .env van een project op de server lezen en wijzigen. De app werkt via de SSH-verbinding, dus ze toont de huidige waarden en die lopen nooit via rdev.cloud.
  • Gotify: als je meldingen naar een Gotify-server gaan, luistert de app ernaar en toont elk bericht als bureaubladmelding met een geluid. Voer het adres van de server en een clienttoken in (Gotify Clients); voeg een applicatietoken toe (Gotify Apps) om een testbericht te sturen. De tokens blijven op deze laptop.
  • Integraties: de Git-toegang van je server: zijn sleutel, zoveel GitHub-, GitLab-, Bitbucket- en andere accounts als je wilt (elk met een eigen SSH-sleutel of een token), hosts die op vertrouwen wachten en een toegangstest. Tokens gaan via SSH naar de server en nooit via rdev.cloud.
  • Instellingen: de terminalapp die Terminal op de server opent (elke geïnstalleerde, zoals Terminal, iTerm2 of Warp; onthouden tot je haar wijzigt), het menubalkpictogram (monochroom, dat een lichte of donkere menubalk volgt, of het gekleurde app-pictogram), schermafbeeldingssynchronisatie en je account: kies Inloggen met rdev.cloud, bevestig je wachtwoord in de browser, controleer of dezelfde code wordt getoond en keur goed. Aangemelde apps staan onder Instellingen > Gekoppelde apps in je paneel en kunnen daar worden losgekoppeld.
  • Over: de versies van de app en de opdracht rdev, en de nieuwste app op rdev.cloud.

De ingebouwde terminal

Terminal on the server opent de ingebouwde terminal van rdev: een eigen venster dat je kunt vergroten, verkleinen, maximaliseren of schermvullend maken, en dat weer op het laatste formaat opent. Hij logt in met ssh rdev en sluit aan bij de blijvende sessie van je server, dus het venster sluiten of het netwerk kwijtraken stopt nooit een agent; valt de verbinding weg, dan verbindt hij zelf opnieuw en ben je terug waar je was.

  • Kopiëren en plakken: Cmd-C en Cmd-V op macOS, Ctrl-Shift-C en Ctrl-Shift-V op Linux en Windows. Tekst die je op de server kopieert, bijvoorbeeld in vim, komt op het klembord van je laptop. Met schermafbeeldingen aan stuurt het plakken van een afbeelding die naar de server en plakt het pad, klaar voor je agent.
  • Shift-Enter begint een nieuwe regel in de prompt van Claude Code.
  • Zoeken met Cmd-F (Ctrl-Shift-F op Linux en Windows); de tekstgrootte wijzig je met Cmd en +, − of 0 (Ctrl op Linux en Windows).
  • Links openen in je browser, ook https://<naam>.dev.test-sites. Is het venster op de achtergrond en laat de terminal zijn bel horen, bijvoorbeeld als een agent je nodig heeft, dan krijg je een melding.
  • Open in an external terminal opent dezelfde sessie in een terminal-app: de knop naast Terminal on the server, het menu van het menubalkpictogram of Cmd-Shift-O (Ctrl-Shift-O) in de ingebouwde terminal. Kies een terminal-app onder Settings om hem de standaard te maken. External terminal onder Settings kiest welke app het gebruikt; eerst is dat de eerder gekozen terminal-app, of op een Mac Terminal.

De app controleert op een nieuwere versie bij het starten, elke zes uur en wanneer je Over opent. Is die er, dan meldt een balk boven de tabbladen dat: kies Bijwerken en de app downloadt haar, controleert haar handtekening, installeert haar en herstart (op Linux vragen de .deb en .rpm om je wachtwoord; op Windows draait het installatieprogramma zelf). Bijwerken in de app vereist 0.2.0-beta.34 of nieuwer; installeer oudere versies eenmalig met de hand eroverheen. Het commando rdev op je laptop werk je apart bij: voer het installatiecommando opnieuw uit, curl -fsSL https://rdev.cloud/install | sh -s -- laptop. Op Windows wordt het commando met de app meegeleverd en samen met de app bijgewerkt. Is het commando ouder dan de app, dan toont About dat commando met een kopieerknop.

Het venster sluiten houdt rdev in de menubalk en haalt het uit het Dock en Cmd-Tab; Quit in het menu van het menubalkpictogram, of Cmd-Q, sluit het af.

Onder Settings (laptopapp 1.4.3 of nieuwer) start Open at login rdev op de achtergrond wanneer je inlogt, meteen in de menubalk of het systeemvak, en Keep running when the window is closed (standaard aan) bepaalt of het sluiten van het venster rdev daar houdt of afsluit. Als de optie aan staat, blijven bestandssynchronisatie en meldingen werken terwijl het venster gesloten is. GNOME toont systeemvakpictogrammen alleen met de AppIndicator-extensie (Ubuntu heeft die); zonder die extensie laat een gesloten venster geen pictogram over om op te klikken, dus open rdev opnieuw via je appmenu. De app waarschuwt hiervoor onder Settings (laptopapp 1.4.4 of nieuwer). Openen bij het inloggen heeft geen beheerdersrechten nodig: rdev voegt alleen voor jouw gebruiker een login-item toe (een launch agent op macOS, een autostart-item op Linux, een Run-item in het register van jouw gebruiker op Windows).

De app past de synchronisatieregels van het paneel ook elke vijf minuten toe zolang ze draait.

Firefox houdt een eigen lijst met certificaten bij. Op Linux voegt rdev zijn certificaat toe aan Chrome en aan elk Firefox-profiel dat het vindt, inclusief de snap-Firefox die Ubuntu levert en de Flatpak-variant (rdev 0.2.0-beta.34 of nieuwer); herstart Firefox daarna. Voor een later gemaakt Firefox-profiel, of op macOS en Windows, importeer je ~/.config/rdev/ca.pem onder Settings > Privacy & Security > Certificates.