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

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

rdev nutzen

Projekte und Sites

Jedes Projekt auf Ihrem Server wird zu einer Site mit eigener Adresse und vertrauenswürdigem HTTPS.

Site-Adressen

Jedes Projekt erhält https://<name>.dev.test. Das Zertifikat wird von Ihrem Laptop als vertrauenswürdig eingestuft, sodass der Browser keine Warnungen zeigt, und die Adresse funktioniert überall dort, wo Ihr Laptop mit Ihrem Tailnet verbunden ist.

PHP

  • Jede PHP-Version von 7.4 bis 8.5, pro Site wählbar.
  • Laravel und WordPress werden erstklassig unterstützt.
  • Andere PHP-Frameworks und einfache PHP-Projekte werden ebenfalls unterstützt.
  • Erweiterungen wie mongodb und xdebug installieren sich mit einem Befehl; siehe PHP-Erweiterungen.

Andere Sprachen

Python-, Ruby-, Node.js-, Go-, .NET-, Java- und Flutter-Projekte werden unterstützt. Standardmäßig wird keine Sprachlaufzeit installiert: Wenn Sie ein Projekt in einer dieser Sprachen hinzufügen, installiert rdev in diesem Moment die benötigte Laufzeit und verwendet sie für spätere Projekte weiter.

So bleibt die Umgebung klein, und Laufzeiten, die Sie nie verwenden, brauchen keine Updates.

Datenbanken und Dienste

Jedes Projekt kann MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense oder RustFS in der gewünschten Version nutzen, dazu Mail-Erfassung und einen Dump-Server. Wofür jeder Dienst gedacht ist, die Versionen, die .env-Einstellungen und wie Sie etwas ausführen, das nicht auf der Liste steht, finden Sie unter Dienste.

Ein Projekt hinzufügen

Sie können ein Projekt auf drei Arten hinzufügen:

  • indem Sie Ihren KI-Agenten bitten, der Sites über seinen MCP-Zugriff erstellt;
  • mit dem Kommandozeilenwerkzeug rdev auf dem Server;
  • über das Web-Panel.

Jeder Ordner, den Sie in ~/Code anlegen, wird sofort unter https://<folder>.dev.test bereitgestellt; ein PHP-Projekt dorthin zu klonen genügt also.

Rezepte: Start mit einem Framework

Ein Rezept startet ein neues Projekt aus einem Framework in einem leeren Ordner ~/Code/<name>: rdev installiert die Sprache, führt den eigenen Installer des Frameworks aus, legt den Befehl des Entwicklungsservers fest und stellt die App unter https://<name>.dev.test bereit.

Sprache Rezepte
PHP Laravel und WordPress (integriert), Symfony, Statamic, CodeIgniter, CakePHP, Drupal
Node.js Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (mit Capacitor), Expo (React Native), NestJS, Express, ein leeres Node.js-Projekt
Python Django, Flask, FastAPI, ein leeres Python-Projekt (jeweils in einer eigenen .venv)
Ruby Ruby on Rails, Sinatra, ein leeres Rack-Projekt
Go Gin, Echo, Fiber, ein leeres Go-Modul
.NET ASP.NET Core Web API, Blazor, eine leere ASP.NET-Core-App
Java Spring Boot, Quarkus, Micronaut, ein leeres Java-Projekt
Flutter Eine Flutter-App für Web, Android und iOS, mit Live-Webvorschau; ein Dart-HTTP-Server (shelf)

Die mobilen Rezepte (Ionic, Expo und Flutter) führen die Webvorschau der App auf dem Server aus; Android- und iOS-Builds entstehen auf Ihrem Laptop. Expo Go auf einem Smartphone in Ihrem Tailnet kann ein Expo-Projekt außerdem direkt vom Server öffnen.

  • Im Panel: Öffnen Sie den Server unter Server, wechseln Sie zum Tab Rezepte und wählen Sie bei einem Rezept Projekt erstellen, oder wählen Sie es als Typ bei Projekt hinzufügen. Das Projekt erscheint dann im Tab Projekte.
  • Auf dem Server: rdev project recipes listet sie auf; rdev project add web --recipe nextjs startet eines.
  • Über einen Agenten: Das MCP-Tool, das Projekte hinzufügt, nimmt ein recipe entgegen, sodass Sie sagen können: „Starte ein Django-Projekt namens api“.

Django und Rails sind so eingerichtet, dass sie *.dev.test-Adressen akzeptieren; auch Vite-basierte Entwicklungsserver (Nuxt, Astro, SvelteKit) lassen sie zu. Rezepte stammen aus einem von rdev signierten Katalog, und der Server lehnt einen Katalog ab, dessen Signatur nicht stimmt, sodass neue Frameworks ohne rdev-Update ankommen. Rezepte erfordern rdev 0.2.0-beta.38 oder neuer.

Über die Kommandozeile

  • Ein Repository klonen und als Projekt bereitstellen:

    rdev project add shop --git [email protected]:you/shop.git
    
  • Ein leeres Python-Projekt mit seiner Laufzeit starten:

    rdev project add api --lang python
    
  • Eine Site mit einer anderen PHP-Version bereitstellen:

    rdev use shop 8.3
    

    Klicken Sie im Panel in der Spalte Projekte der PHP-Karte des Servers auf das Projekt (PHP-Erweiterungen).

rdev project list zeigt Ihre Projekte, rdev project start|stop|logs <name> steuert den Entwicklungsserver eines Nicht-PHP-Projekts, und rdev project remove <name> entfernt eines (seine Dateien bleiben, es sei denn, Sie fügen --delete-files hinzu).

Über das Panel

Sie können ein Projekt auch hinzufügen, ohne ein Terminal zu öffnen: Öffnen Sie den Server unter Server und wählen Sie im Tab Projekte die Option Hinzufügen, oder wählen Sie im Dashboard neben einem Server Projekt hinzufügen; geben Sie einen Namen ein und wählen Sie einen Typ: eine neue Laravel-App, eine neue WordPress-Site, den Klon eines Git-Repositorys, ein leeres PHP-Projekt oder eines der Rezepte. Der Server übernimmt die Anfrage innerhalb von etwa fünf Minuten, und das Dashboard zeigt, wann es unter https://<name>.dev.test bereit ist. Die Tabelle Über das Panel hinzugefügt im Dashboard listet jedes Projekt und jeden Dienst auf, die Sie angefordert haben, mit Server, Status und, falls etwas fehlgeschlagen ist, dem Grund. rdev verbindet sich dafür nie mit Ihrem Server; Ihr Server fragt seine Anfragen selbst ab. Für ein Git-Repository können Sie auch die Sprache wählen (PHP, Node.js, Python, Ruby, Go, .NET oder Java); bei Automatisch erkennen liest der Server sie aus den Dateien des Repositorys. Passen Wahl und Dateien nicht zusammen, nutzt der Server Ihre Wahl und vermerkt das im Status des Projekts.

Der Tab Projekte listet jedes Projekt auf, das der Server meldet, mit seiner Adresse, sowie die von Ihnen angeforderten, die noch unterwegs sind oder fehlgeschlagen sind, mit dem Grund.

Korrigieren, entfernen und Aliase

Das Menü ⋯ bei einem Projekt im Tab Projekte:

  • Bearbeiten und erneut versuchen (ein Projekt, dessen Einrichtung fehlgeschlagen ist): Das Formular öffnet sich mit Ihren Angaben, zum Beispiel der Repository-URL oder dem Rezept. Korrigieren Sie sie und senden Sie die Anfrage erneut. Aus der Liste entfernen blendet die fehlgeschlagene Anfrage aus.
  • Bearbeiten und neu installieren (ein Projekt auf dem Server): Der Ordner des Projekts wird gelöscht und mit dem gewählten Typ von Grund auf neu eingerichtet. Seine Daten bleiben erhalten, sodass das neue Projekt sie findet, es sei denn, Sie setzen den Haken bei Auch die Datenbanken löschen (was dabei gelöscht wird, steht unten). Committen und pushen Sie zuerst Ihre Arbeit: Dateien, die nicht in Git liegen, sind weg.
  • Entfernen, Daten behalten löscht den Ordner des Projekts in ~/Code, seine Site und seinen Dev-Server; seine Datenbanken und Dateien im Speicher bleiben. Vollständig entfernen, mit Daten löscht zusätzlich die Daten des Projekts: die nach ihm benannten MySQL-, MariaDB-, PostgreSQL- und MongoDB-Datenbanken (my-shop verwendet my_shop) und seinen RustFS-Bucket (my-shop) mit allen hochgeladenen Dateien.
  • Alias hinzufügen gibt dem Projekt eine weitere Adresse: Der Alias store lässt https://store.dev.test dieselbe Site öffnen, auf Ihrem Laptop und auf jedem Gerät in Ihrem Tailnet. Punkte erzeugen Unteradressen wie api.shop. Die Aliase erscheinen unter dem Projekt; das × bei einem entfernt ihn.

Der Server führt jede Aktion innerhalb weniger Sekunden aus; dafür ist rdev 1.0.3 oder neuer nötig, zum Löschen von MongoDB- und RustFS-Daten 1.0.4. Auf dem Server selbst fügt rdev domain add <name> store.dev.test einen Alias hinzu, und rdev project remove <name> --delete-files entfernt ein mit rdev project add erstelltes Projekt (bei einer Laravel- oder WordPress-Site löschen Sie deren Ordner).

Bevor Sie Daten löschen, sollten Sie wissen, was davon betroffen ist:

  • Es lässt sich nicht rückgängig machen. Das nächtliche Backup bei Pro und Team enthält die Datenbanken, sodass Sie sie über das Panel wiederherstellen können; RustFS-Buckets enthält es nicht, hochgeladene Dateien sind also endgültig weg. Laden Sie vorher herunter, was Sie brauchen.
  • Es richtet sich nach dem Namen, nicht nach dem Eigentümer. rdev löscht die nach dem Projekt benannte Datenbank und den nach ihm benannten Bucket. Zeigt die .env eines anderen Projekts auf dieselbe Datenbank oder denselben Bucket, verliert auch dieses Projekt seine Daten.
  • Ein gestoppter Dienst behält seine Daten. rdev löscht nur in laufenden Diensten und nennt die übersprungenen; starten Sie sie und führen Sie das Entfernen erneut aus, oder löschen Sie die Daten selbst.
  • Bei einem Team-Tarif hat die Umgebung jedes Mitglieds eigene Dienste; das Entfernen eines Projekts in Ihrer Umgebung berührt nie die gemeinsamen Dienste des Eigentümers.

Einem Projekt einen Dienst hinzufügen

Ein Projekt kann später einen Dienst erhalten, wenn es einen braucht:

rdev project service shop postgres

Wählen Sie im Panel bei einem Projekt oder neben einem Server Dienst hinzufügen. Die Wahl einer Version, die .env-Einstellungen und alles Weitere finden Sie unter Dienste.

Umgebungsvariablen über das Panel

Um einen API-Schlüssel oder ein anderes Geheimnis festzulegen, ohne ein Terminal zu öffnen, öffnen Sie den Server über Server in der Seitenleiste und verwenden Umgebungsvariablen: Wählen Sie das Projekt, geben Sie unter Hinzufügen oder ändern einen Namen und einen Wert ein und wählen Sie Verschlüsseln und speichern. Der Server schreibt ihn innerhalb von Sekunden in die .env des Projekts.

Die Werte werden in Ihrem Browser mit dem eigenen Schlüssel Ihres Servers verschlüsselt, sodass rdev.cloud sie nie sieht und später nicht anzeigen kann. Aktuell in .env listet nur die Namen auf. Um einen Wert zu ändern, klicken Sie auf seinen Namen: Er wandert nach Hinzufügen oder ändern, wo Sie den neuen Wert eingeben. Klicken Sie auf × neben einem Namen, um ihn zu entfernen; das Entfernen von APP_KEY oder DB_-Einstellungen führt meist dazu, dass die App nicht mehr funktioniert.