Geben Sie mindestens zwei Buchstaben ein, um alle Seiten der Doku zu durchsuchen.

↑ ↓ zum Navigieren ↵ zum Öffnen esc zum Schließen

rdev nutzen

Laptop verbinden

Ihr Laptop ist der Editor und der Browser. Der Code, die Dienste und die Agenten bleiben auf Ihrem Server.

Ihr eigenes Tailnet

Ihr Laptop und Ihr Server sprechen über ein privates Tailscale-Netzwerk, das zu Ihrem Tailscale-Konto gehört. rdev tritt ihm nie bei. Das Installationsprogramm verbindet Ihren Server mit einem Schlüssel aus Ihrem Konto, und die Laptop-App verbindet Ihren Laptop.

Dateisynchronisierung

rdev hält Ihre Projektdateien zwischen Laptop und Server in beide Richtungen synchron. Ordner, die nicht mitreisen müssen, etwa node_modules, vendor und Build-Ausgaben, werden von Anfang an ignoriert.

Was synchronisiert wird, wählen Sie in Ihrem Panel unter Dashboard > Ihr Server > Einstellungen:

  • Mit Laptops synchronisieren: Schalten Sie es aus, um vollständig remote zu arbeiten. Nichts wird auf den Laptop kopiert; Ihr Editor öffnet Projekte per SSH (ssh rdev, Remote-SSH von VS Code oder Cursor, PhpStorm Gateway). Sites und .dev.test funktionieren weiter.
  • Projekte auf Laptops: Deaktivieren Sie ein Projekt, um es nur auf dem Server zu behalten. Eine bereits auf Ihrem Laptop vorhandene Kopie bleibt unberührt, löschen Sie sie also, wenn Sie sie nicht mehr brauchen. Wenn ein Projekt später wieder synchronisiert wird, wird die ältere Laptop-Kopie zuerst nach ~/Code-rdev-old/ verschoben, und die Kopie des Servers kommt herunter.
  • Nie synchronisiert: die Standard-Ausschlüsse, von denen Sie jeden abschalten können, plus Ihre eigenen Muster in einer .gitignore-ähnlichen Syntax.

Laptops wenden die neuen Regeln innerhalb weniger Minuten an. Führen Sie rdev laptop sync aus, um sie sofort anzuwenden.

Editoren und der Browser

Verwenden Sie den Editor, den Sie schon kennen, etwa VS Code oder PhpStorm, auf den synchronisierten Dateien. Öffnen Sie Ihre Sites in Ihrem gewohnten Browser unter https://<name>.dev.test; die Laptop-App richtet die Namensauflösung und ein vertrauenswürdiges Zertifikat für diese Adressen ein.

Dateifreigabe

Ein Terminal auf Ihrem Server kann keine Datei einfügen, daher gibt rdev Ihrem Agenten einen gemeinsamen Ordner. Alles in ~/rdev-share auf Ihrem Laptop wird innerhalb von Sekunden nach ~/Share/<laptop name> auf dem Server kopiert, auch wenn die Dateisynchronisierung aus ist; jeder Laptop hat dort einen eigenen Ordner, sodass mehrere Laptops gleichzeitig teilen können. Bitten Sie Ihren Agenten, „sich den letzten Screenshot anzusehen“ oder „die Datei zu öffnen, die ich gerade gesendet habe“, und er öffnet die neueste. Jede Art von Datei funktioniert: Bilder, PDFs, Logs, Exporte.

  • Send clipboard in der App (auch in ihrem Menüleisten- oder Tray-Symbol) sendet die Dateien, die Sie im Finder, Explorer oder Ihrem Dateimanager kopiert haben, oder andernfalls das Bild in Ihrer Zwischenablage. Es wartet, bis sie den Server erreichen, und legt ihre Serverpfade in Ihre Zwischenablage; fügen Sie diese beim Agenten ein. Im Terminal: rdev laptop share send oder rdev laptop share send <files>.
  • Ziehen Sie Dateien auf das App-Fenster, um sie auf dieselbe Weise zu senden.
  • Der umgekehrte Weg: Dateien, die Ihr Agent auf dem Server in ~/Share/<laptop name>/out ablegt, kommen auf Ihrem Laptop in ~/rdev-share/from-server an. Bitten Sie ihn, „den Bericht in out abzulegen“.
  • Save macOS screenshots here lässt Umschalt-Befehl-3, 4 und 5 in ~/rdev-share speichern (rdev laptop share macos). Auch Screenshot-Apps wie Shottr oder CleanShot können dort speichern.
  • Dateien werden nach 7 Tagen auf beiden Seiten gelöscht; ändern Sie das unter Keep files for (days) in der App oder mit rdev laptop share keep <days> (0 behält sie). Dateien in einem Ordner keep werden nie gelöscht.
  • Dateien über 500 MB werden nicht gesendet; verschieben Sie diese mit scp oder rsync. Alles geht direkt an Ihren Server und läuft nie über rdev.cloud. Schalten Sie die Freigabe mit dem Schalter in der App oder rdev laptop share off aus.

Vor 1.2.0 war dies der Screenshot-Ordner: ~/rdev-shots wird von selbst nach ~/rdev-share und ~/Shots nach ~/Share verschoben, und ~/Shots funktioniert als Link weiter.

Unterstützte Laptops

Die Laptop-App und rdev laptop laufen unter macOS (Apple Silicon und Intel), Linux (x64 und ARM64) sowie Windows 10 und 11 (x64 und ARM64); die App erhalten Sie auf der Download-Seite. Unter Linux können Sie sie stattdessen mit einem Befehl installieren, der unter Debian und Ubuntu das .deb, unter Fedora das .rpm und sonst das AppImage nimmt, zum Beispiel unter Arch und CachyOS: curl -fsSL https://rdev.cloud/install | sh -s -- app. Das AppImage landet in ~/.local/bin und erscheint in Ihrem Anwendungsmenü; die App lässt diesen Eintrag auf die Datei zeigen, wenn Sie sie verschieben (ab 1.4.4). Wenn Sie das .deb selbst herunterladen, installieren Sie es aus /tmp (sudo apt install /tmp/rdev-linux-arm64.deb, oder -x64); aus Ihrem Home-Ordner funktioniert apt auch, weist aber darauf hin, dass sein Sandbox-Benutzer die Datei nicht lesen kann. Unter Linux leitet rdev *.dev.test über systemd-resolved an Ihren Server, das die meisten Distributionen verwenden. Wenn es ausgeschaltet oder maskiert ist, wie bei manchen Images virtueller Maschinen, sagt rdev laptop connect das und zeigt, wie Sie es einschalten: sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved, dann sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf, und verbinden Sie sich erneut. Wenn NetworkManager neben einem laufenden systemd-resolved eine eigene /etc/resolv.conf führt (Tailscale meldet dann, dass sie „wired together incorrectly“ sind), erreichen Anfragen nie die Route von rdev; rdev laptop connect und rdev laptop status sagen das (ab 1.4.4), und derselbe ln -sf-Befehl behebt es. rdev fügt sein Zertifikat unter Debian, Ubuntu, Fedora, openSUSE, Arch und CachyOS zu den vertrauenswürdigen Zertifikaten des Systems hinzu; vor 1.4.4 brach die Verbindung unter Arch und CachyOS an dieser Stelle ab.

Schritt für Schritt verbinden

  1. Installieren Sie Tailscale auf Ihrem Laptop und melden Sie sich mit demselben Tailscale-Konto an, das Ihr Server verwendet. Unter Linux können Sie das überspringen: Fehlt Tailscale, installiert rdev laptop connect es aus dem offiziellen Repository von Tailscale und startet die Anmeldung, die Sie in Ihrem Browser abschließen.
  2. Installieren Sie rdev auf Ihrem Laptop und verbinden Sie es. Führen Sie dies als Ihr eigener Benutzer in einem Terminal aus und geben Sie auf Nachfrage Ihr Laptop-Passwort ein; es wird gebraucht, um rdev zu installieren, dem Zertifikat zu vertrauen und die Namensauflösung einzurichten:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop

Es installiert den Befehl rdev und führt rdev laptop connect aus, das Ihren Server in Ihrem Tailnet findet, einen Eintrag rdev in Ihrer SSH-Konfiguration hinzufügt, dem Zertifikat Ihrer Umgebung vertraut, *.dev.test an Ihren Server leitet und beginnt, Ihren Ordner ~/Code mit ~/Code auf dem Server zu synchronisieren.

Sie installieren vorher nichts anderes. Fehlt das Synchronisierungs-Tool, installiert rdev eine festgelegte, per Prüfsumme verifizierte Kopie in ~/.local/share/rdev/bin; ein bereits vorhandenes wird unverändert verwendet. Unter Linux installiert es außerdem die für Screenshots benötigten Zwischenablage-Tools (wl-clipboard, xclip) und certutil, das das Zertifikat in Chrome ablegt, mit Ihrem Paketmanager, bei derselben Passwortabfrage. Wenn Sie dem Server bei der Installation einen anderen Namen gegeben haben, fügen Sie --server <name> hinzu; um einen anderen Ordner zu synchronisieren, fügen Sie --code-dir <folder> hinzu. Führen Sie rdev laptop connect erneut aus, wann immer Sie die Einrichtung wiederholen möchten.

Bevor rdev laptop connect nach Ihrem Passwort fragt, prüft es den Ordner, den es synchronisieren will. Es hält an und schlägt --code-dir <Ordner> vor, wenn eine andere Synchronisierung diesen Ordner oder einen übergeordneten bereits synchronisiert (zusätzlich mit rdev würde alles zwischen drei Rechnern kopiert); mit --force oder Trotzdem synchronisieren in der App wird er dennoch synchronisiert. Ein Ordner über 5 GB verbindet sich ebenfalls, mit dem Hinweis, dass die erste Synchronisierung dauert (ab rdev 1.1.10; vorher hielt es an).

Auf einem Mac, der dev.test bereits anderswohin leitet, zum Beispiel an einen anderen Entwicklungsserver, legt rdev diese Einstellung beiseite und stellt sie wieder her, wenn Sie die Verbindung trennen oder deinstallieren.

Unter Windows gilt der obige curl-Befehl nicht: Installieren Sie die App von der Download-Seite und verbinden Sie sich über sie. Ab Laptop-App 1.4.2 installiert die App außerdem den Befehl rdev in %USERPROFILE%\.local\share\rdev\bin und fügt diesen Ordner Ihrem PATH hinzu; öffnen Sie ein neues Terminal, um ihn zu verwenden. Dafür sind keine Administratorrechte nötig, und er wird mit der App aktualisiert.

Zeigt die App weiter Check connection an, während Dateien synchronisiert werden, und meldet rdev laptop status *.dev.test resolves to …, not the server, sehen Sie auf der Seite DNS der Tailscale-Admin-Konsole nach. Ein Split-DNS-Eintrag für dev.test, der auf einen anderen Rechner zeigt, etwa einen alten Server, hat unter Windows Vorrang vor der Einstellung von rdev. Entfernen Sie ihn oder lassen Sie ihn auf Ihren Server zeigen.

Prüfen Sie die Verbindung jederzeit mit rdev laptop status. rdev laptop disconnect stoppt die Synchronisierung und entfernt die Einstellungen; Ihre Dateien bleiben auf beiden Seiten.

rdev von Ihrem Laptop entfernen

rdev laptop uninstall

Es trennt die Verbindung, vertraut dem Zertifikat Ihrer Umgebung nicht mehr und entfernt den Befehl rdev, seine Einstellungen und die von ihm installierten Tools. Ihr synchronisierter Ordner und ~/rdev-share bleiben. Das von rdev installierte Synchronisierungs-Tool bleibt ebenfalls, solange andere Synchronisierungssitzungen es noch verwenden. Es fragt einmal nach Ihrem Laptop-Passwort und erfordert rdev 0.2.0-beta.21 oder neuer.

Ihr Laptop muss sich am Server anmelden können: Das Installationsprogramm kopiert die SSH-Schlüssel, die sich bei der Installation am Server anmelden konnten. Um einen weiteren Laptop hinzuzufügen, fügen Sie seinen öffentlichen Schlüssel auf der Seite Ihres Servers im Panel unter SSH-Schlüssel hinzu (einen pro Zeile, also auch mehrere Computer auf einmal; wenn Sie einen hinzufügen, können Sie ihm einen Namen wie Arbeitslaptop geben, andernfalls wird der Name am Ende des Schlüssels angezeigt); der Server lässt ihn innerhalb von Sekunden zu. Das erfordert rdev 0.2.0-beta.33 oder neuer; davor legen Sie den Schlüssel in /opt/rdev/home/.ssh/authorized_keys auf dem Server ab. Wenn rdev laptop connect meldet, dass es sich nicht anmelden kann, fehlt genau das.

Sobald Sie verbunden sind, öffnen Sie mit ssh rdev ein Terminal auf dem Server und starten dort Ihren Agenten; öffnen Sie Ihre Sites im Browser unter https://<folder>.dev.test. rdev open <Projekt> öffnet ein Terminal auf dem Server direkt im Ordner eines Projekts, in Ihrer dauerhaften Sitzung; ohne Namen listet es die Projekte auf (ab rdev 1.1.11).

Die Mac-App

Klicken Sie lieber, als zu tippen? Laden Sie die rdev-App für Mac herunter (Apple Silicon und Intel, von Apple signiert und notarisiert), ziehen Sie sie in den Ordner Programme und öffnen Sie sie. Sie zeigt, ob Ihr Laptop verbunden ist, verbindet und trennt mit einer Schaltfläche und öffnet ein Terminal auf Ihrem Server. Sie führt dieselbe Einrichtung wie rdev laptop connect aus, Sie brauchen also Tailscale (Schritt 1), aber nicht den Befehl; die App installiert das Synchronisierungs-Tool selbst. Vor dem Verbinden können Sie den Ordner ändern, in den Ihre Projekte synchronisiert werden (standardmäßig ~/Code), die App-Variante von --code-dir.

Beim ersten Start führt die App Schritt für Schritt durch die Einrichtung, und ihre Tabs öffnen sich erst, wenn jeder Schritt geklappt hat: Mit dem rdev-Konto anmelden, prüfen, dass Tailscale installiert und angemeldet ist, den Server aus Ihrem Konto wählen, diesen Laptop hineinlassen (die App fügt seinen SSH-Schlüssel selbst zum Server hinzu und erstellt einen, falls keiner existiert), mit Durchsuchen… den Ordner wählen, in den Ihre Projekte synchronisiert werden, und verbinden. Später richtet Server wechseln im Tab Sites den Laptop für einen anderen Server neu ein. Ist der Server des Laptops weg, nicht erreichbar oder nicht mehr in Ihrem Konto, sagt die App das und bietet Neu einrichten an. Ihre Dateien bleiben in beiden Fällen, wo sie sind. Ist der Befehl rdev älter als die App, zeigt About die Schaltfläche Im Terminal ausführen, die Ihr Terminal mit dem Update-Befehl öffnet.

Die App hat sieben Tabs:

  • Sites: Ihre Projekte als Links https://<name>.dev.test, ein Terminal auf dem Server und Ihre geteilten Dateien. Jede Site hat Open in Terminal, das ein Terminal im Ordner dieses Projekts auf dem Server öffnet. Der Tab Sites hat außerdem die Schaltflächen Mail und Dumps, die Ihre abgefangenen E-Mails und die Dump-Seite öffnen. Außerdem gibt es eine Schaltfläche Web terminal, die das Web-Terminal öffnet. Außerdem gibt es eine Schaltfläche Errors, die die Fehlerverfolgung öffnet.
  • Sync: dieselben Einstellungen wie in Ihrem Panel (Synchronisierung an oder aus, Projekte auf diesem Laptop, Ausschlüsse). Das Speichern wendet sie sofort auf diesem Laptop an.
  • Env: die .env eines Projekts auf dem Server lesen und ändern. Die App arbeitet über die SSH-Verbindung und zeigt daher die aktuellen Werte, die nie über rdev.cloud laufen.
  • Gotify: Wenn Ihre Benachrichtigungen an einen Gotify-Server gehen, hört die App ihn ab und zeigt jede Nachricht als Desktop-Benachrichtigung mit Ton an. Geben Sie die Adresse des Servers und einen Client-Token (Gotify Clients) ein; fügen Sie einen Anwendungstoken (Gotify Apps) hinzu, um eine Testnachricht zu senden. Die Tokens bleiben auf diesem Laptop.
  • Integrations: der Git-Zugriff Ihres Servers: sein Schlüssel, beliebig viele GitHub-, GitLab-, Bitbucket- und andere Konten (jedes mit eigenem SSH-Schlüssel oder einem Token), Hosts, die auf Vertrauensstellung warten, und ein Zugriffstest. Tokens gehen per SSH an den Server, nie über rdev.cloud.
  • Settings: die Terminal-App, die Terminal on the server öffnet (eine beliebige installierte, etwa Terminal, iTerm2 oder Warp; bleibt gespeichert, bis Sie sie ändern), das Menüleistensymbol (monochrom, passend zu einer hellen oder dunklen Menüleiste, oder das farbige App-Symbol), die Screenshot-Synchronisierung und Ihr Konto: Wählen Sie Sign in with rdev.cloud, bestätigen Sie Ihr Passwort im Browser, prüfen Sie, dass derselbe Code angezeigt wird, und geben Sie frei. Angemeldete Apps werden in Ihrem Panel unter Einstellungen > Verbundene Apps aufgelistet und können dort getrennt werden.
  • About: die Versionen der App und des Befehls rdev sowie die neueste App auf rdev.cloud.

Das integrierte Terminal

Terminal on the server öffnet das integrierte Terminal von rdev: ein eigenes Fenster, das Sie in der Größe ändern, maximieren oder im Vollbild nutzen können und das in seiner letzten Größe wieder aufgeht. Es meldet sich mit ssh rdev an und tritt der dauerhaften Sitzung Ihres Servers bei, sodass weder das Schließen des Fensters noch ein Netzausfall einen Agenten stoppt; bricht die Verbindung ab, verbindet es sich selbst neu und Sie sind wieder dort, wo Sie aufgehört haben.

  • Kopieren und Einfügen: Cmd-C und Cmd-V unter macOS, Ctrl-Shift-C und Ctrl-Shift-V unter Linux und Windows. Auf dem Server kopierter Text, etwa in vim, landet in der Zwischenablage Ihres Laptops. Bei eingeschalteten Screenshots schickt das Einfügen eines Bildes es an den Server und fügt seinen Pfad ein, bereit für Ihren Agenten.
  • Shift-Enter beginnt eine neue Zeile in der Eingabe von Claude Code.
  • Suchen mit Cmd-F (Ctrl-Shift-F unter Linux und Windows); die Schriftgröße ändern Sie mit Cmd und +, − oder 0 (Ctrl unter Linux und Windows).
  • Links öffnen sich in Ihrem Browser, auch https://<name>.dev.test-Sites. Läutet das Terminal die Glocke, während das Fenster im Hintergrund ist, etwa wenn ein Agent Sie braucht, erhalten Sie eine Desktop-Benachrichtigung.
  • Open in an external terminal öffnet dieselbe Sitzung stattdessen in einer Terminal-App: über die Schaltfläche neben Terminal on the server, das Menü des Menüleistensymbols oder Cmd-Shift-O (Ctrl-Shift-O) im integrierten Terminal. Um eine Terminal-App zum Standard zu machen, wählen Sie sie unter Settings. Welche App es nutzt, wählt External terminal unter Settings; anfangs ist es die zuvor gewählte Terminal-App, auf dem Mac sonst Terminal.

Die App prüft beim Start, alle sechs Stunden und beim Öffnen von About auf eine neuere Version. Gibt es eine, sagt das eine Leiste über den Tabs: Wählen Sie Update, und die App lädt sie herunter, prüft ihre Signatur, installiert sie und startet neu (unter Linux fragen das .deb und das .rpm nach Ihrem Passwort; unter Windows läuft das Installationsprogramm selbstständig). Das Aktualisieren in der App erfordert 0.2.0-beta.34 oder neuer; installieren Sie ältere Versionen einmal von Hand darüber. Der Befehl rdev auf Ihrem Laptop wird separat aktualisiert: Führen Sie den Installationsbefehl erneut aus, curl -fsSL https://rdev.cloud/install | sh -s -- laptop. Unter Windows kommt er mit der App und wird mit ihr aktualisiert. Ist der Befehl älter als die App, zeigt About diesen Befehl mit einer Kopierschaltfläche.

Das Schließen des Fensters hält rdev in der Menüleiste und nimmt es aus Dock und Cmd-Tab; Quit im Menü des Menüleistensymbols oder Cmd-Q beendet es.

Unter Settings (Laptop-App 1.4.3 oder neuer) startet Open at login rdev beim Anmelden im Hintergrund, direkt in der Menüleiste oder im Infobereich, und Keep running when the window is closed (standardmäßig an) legt fest, ob das Schließen des Fensters rdev dort weiterlaufen lässt oder beendet. Ist die Option an, laufen Dateisynchronisierung und Benachrichtigungen bei geschlossenem Fenster weiter. GNOME zeigt Tray-Symbole nur mit der AppIndicator-Erweiterung an (Ubuntu hat sie); ohne sie bleibt nach dem Schließen des Fensters kein Symbol zum Anklicken, öffnen Sie rdev dann erneut über Ihr Anwendungsmenü. Die App warnt unter Settings davor (Laptop-App 1.4.4 oder neuer). Das Öffnen bei der Anmeldung braucht keine Administratorrechte: rdev legt nur für Ihren Benutzer einen Anmeldeeintrag an (unter macOS einen Launch Agent, unter Linux einen Autostart-Eintrag, unter Windows einen Run-Eintrag in der Registry Ihres Benutzers).

Die App wendet außerdem die Synchronisierungsregeln des Panels alle fünf Minuten an, solange sie läuft.

Firefox führt eine eigene Zertifikatsliste. Unter Linux fügt rdev sein Zertifikat zu Chrome und zu jedem gefundenen Firefox-Profil hinzu, auch zum Snap-Firefox, den Ubuntu mitliefert, und zum Flatpak-Firefox (rdev 0.2.0-beta.34 oder neuer); starten Sie Firefox danach neu. Für ein später erstelltes Firefox-Profil oder unter macOS und Windows importieren Sie ~/.config/rdev/ca.pem unter Settings > Privacy & Security > Certificates.