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

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

rdev nutzen

Dienste

Datenbanken, Caches, Suche und Dateispeicher laufen in Ihrer Umgebung, neben Ihren Sites. rdev installiert jeden Dienst, sobald ein Projekt ihn zum ersten Mal braucht, in der gewünschten Version, hält ihn am Laufen und schreibt die Verbindungseinstellungen in die .env des Projekts.

Was verfügbar ist

Dienst Wofür er gedacht ist Versionen Standard-Port
MySQL Relationale Datenbank 8.0, 8.4, 9.7 3306
MariaDB Relationale Datenbank 10.11, 11.4, 11.8, 12.3 3307
PostgreSQL Relationale Datenbank; die -full-Builds fügen pgvector, PostGIS, pgRouting und (ab 16) TimescaleDB hinzu 14, 15, 16, 17, 18 5432
MongoDB Dokumentendatenbank 7.0, 8.0, 9.0 27017
Redis Cache, Queues und Sitzungen 9.1 6379
Meilisearch Volltextsuche, für Laravel Scout 1 7700
Typesense Volltextsuche, für Laravel Scout 29, 30 8108
RustFS S3-kompatibler Dateispeicher, mit einer Webkonsole auf dem nächsten Port 1 9000
Elasticsearch Suche und Analytik, für Scout-Treiber und Elastic-Clients (läuft ohne Machine Learning) 8.19, 9 9200
Qdrant Vektorsuche für KI-Funktionen wie die semantische Suche 1 6333
Mail-Erfassung Fängt ausgehende E-Mails ab, damit nichts in echten Postfächern landet; SMTP 127.0.0.1:2525, im Browser unter https://rdev-mail.dev.test integriert
Dump-Server Sammelt Debug-Dumps aus Ihrem Code; 127.0.0.1:2304, im Browser unter https://rdev-dumps.dev.test integriert

Redis spricht das Standard-Redis-Protokoll: Die redis-Treiber von Laravel und phpredis funktionieren unverändert. Jeder Dienst lauscht nur innerhalb Ihrer Umgebung, auf 127.0.0.1; erreichen Sie eine Webkonsole wie die von RustFS über Ihre Laptop-Verbindung.

Abgefangene E-Mails und Dumps im Browser

Öffnen Sie https://rdev-mail.dev.test in einem beliebigen Browser in Ihrem Tailnet, um die von Ihren Apps gesendeten E-Mails zu lesen. Sie sehen die Liste (neueste zuerst), die Header jeder Nachricht, ihre Klartext- und HTML-Version und ihre Anhänge. Sie können eine oder alle Nachrichten löschen, und neue E-Mails erscheinen von selbst. HTML-E-Mails werden mit blockierten Skripten und Remote-Bildern angezeigt.

https://rdev-dumps.dev.test listet dump()-Aufrufe und andere erfasste Ereignisse auf, neueste zuerst, mit Datei und Zeile, aus der sie stammen. Leeren Sie die Liste mit Clear.

Beide Seiten laufen auf Ihrem Server und sind wie Ihre Projekte nur über Ihr Tailnet erreichbar. Die Daten verlassen Ihren Server nie, und eine Vorschau kann sie nie öffentlich machen. rdev mail list gibt beide Adressen aus, und die Laptop-App öffnet sie über Mail und Dumps im Tab Sites. Die Namen rdev-mail und rdev-dumps sind reserviert, ein Projekt kann sie also nicht verwenden.

Datenbanken im Browser

https://rdev-adminer.dev.test öffnet Adminer, einen Datenbankmanager, auf deinem Server. Wähle MySQL oder PostgreSQL, Server 127.0.0.1, Benutzer root (MySQL) oder postgres (PostgreSQL) und lass das Passwort leer; für SQLite gib den Pfad der Datenbankdatei ein. Wie die Seiten oben ist er nur über dein Tailnet erreichbar, und der Name rdev-adminer ist reserviert. Er kommt mit rdev 1.2.0; auf einem früher installierten Server führe zuerst sudo rdev host update aus.

Einem Projekt einen Dienst geben

Nennen Sie auf dem Server das Projekt und den Dienst:

rdev project service shop postgres

rdev installiert und startet den Dienst, falls er noch nicht läuft, legt eine nach dem Projekt benannte Datenbank (MySQL, MariaDB, PostgreSQL) oder einen Bucket (RustFS) an und schreibt die Verbindungseinstellungen in die .env des Projekts. Ein Projekt ohne .env erhält die Einstellungen stattdessen ausgegeben. MongoDB legt die Datenbank an, wenn Ihr Code zum ersten Mal hineinschreibt; bei einem PHP-Projekt installiert rdev außerdem die PHP-Erweiterung mongodb für die PHP-Version, die die Site verwendet (siehe PHP-Erweiterungen).

Wenn ein Laravel-Projekt eine neue MySQL-, MariaDB- oder PostgreSQL-Datenbank erhält, führt rdev außerdem php artisan migrate --force aus, damit die Tabellen, in denen eine neue App ihre Sitzungen, ihren Cache und ihre Queue speichert, vorhanden sind und die Site weiter funktioniert. Das geschieht nur bei einer gerade angelegten, noch leeren Datenbank; eine bestehende Datenbank bleibt unverändert. Schlägt die Migration fehl, bleibt der Dienst bestehen, und die Meldung sagt Ihnen, warum, sodass Sie php artisan migrate selbst ausführen können.

Öffnen Sie im Panel den Server über Server in der Seitenleiste und wählen Sie in der Karte Dienste die Option Dienst hinzufügen, entweder oben oder neben einem Projekt (das Dashboard hat dieselbe Schaltfläche), wählen Sie den Dienst und bei Diensten mit mehreren Versionen die Version. Die Zeile des Projekts zeigt, wo der Server steht: Dienst installieren und starten, Datenbank anlegen, .env schreiben, Migrationen ausführen. Eine Benachrichtigung sagt, wann er bereit ist. Die erstmalige Installation eines Dienstes kann einige Minuten dauern. Ihr KI-Agent kann dasselbe über seinen MCP-Zugriff tun; bitten Sie ihn um „eine PostgreSQL-Datenbank für shop“.

Ein neues Projekt kann seine Dienste mit demselben Befehl erhalten:

rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis

Was in die .env kommt

Dienst Einstellungen
MySQL, MariaDB, PostgreSQL DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (kein Passwort: nur Ihre Umgebung kann ihn erreichen)
MongoDB MONGODB_URI, MONGODB_DATABASE, für das Paket mongodb/laravel-mongodb
Redis REDIS_HOST, REDIS_PORT
Meilisearch SCOUT_DRIVER=meilisearch, MEILISEARCH_HOST
Typesense SCOUT_DRIVER=typesense, TYPESENSE_HOST, TYPESENSE_PORT, TYPESENSE_PROTOCOL, TYPESENSE_API_KEY
Elasticsearch ELASTICSEARCH_HOST (http://127.0.0.1:9200) und ELASTIC_HOST (127.0.0.1:9200); kein SCOUT_DRIVER, da Laravel keinen eingebauten Elasticsearch-Treiber hat: Setzen Sie ihn für das Paket, das Sie verwenden
Qdrant QDRANT_HOST, QDRANT_PORT, QDRANT_URL
RustFS AWS_ACCESS_KEY_ID=rdev, AWS_SECRET_ACCESS_KEY=rdev-secret, AWS_DEFAULT_REGION, AWS_BUCKET, AWS_ENDPOINT, AWS_URL, AWS_USE_PATH_STYLE_ENDPOINT=true

Werte, die für diese Schlüssel bereits in der .env stehen, werden ersetzt; andere Zeilen bleiben unverändert.

Eine Datenbank in einer Desktop-App öffnen

Sie können Ihre Datenbanken mit jeder Datenbank-App auf Ihrem Laptop ansehen und bearbeiten, zum Beispiel TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. Die Dienste lauschen nur innerhalb Ihrer Umgebung, wählen Sie daher die Option SSH (SSH-Tunnel) der App: SSH-Host ist die Tailscale-Adresse Ihres Servers (der HostName im Eintrag rdev in ~/.ssh/config), Benutzer dev, Port 22 und der SSH-Schlüssel, mit dem sich Ihr Laptop anmeldet. Verbinden Sie sich dann mit der Datenbank unter 127.0.0.1 mit Port und Zugangsdaten aus der Tabelle oben. Dafür muss Ihr Laptop verbunden sein; die Daten laufen über Ihr Tailnet und nie über rdev.cloud.

Keine App zur Hand, oder auf Smartphone oder Tablet? https://rdev-adminer.dev.test öffnet Adminer im Browser (siehe den Adminer-Abschnitt oben).

Standardeinstellungen

Jeder Dienst lauscht nur auf 127.0.0.1 innerhalb Ihrer Umgebung, sodass nichts außerhalb ihn erreichen kann, und alle sind für die Entwicklung eingerichtet:

Dienst Zugangsdaten Gut zu wissen
MySQL, MariaDB Benutzer root, kein Passwort Jedes Projekt erhält eine Datenbank mit seinem Namen (my-shop wird zu my_shop).
PostgreSQL Benutzer postgres, kein Passwort (Trust-Authentifizierung) Kein Unix-Socket: Verbinden Sie sich mit 127.0.0.1. Eine Datenbank pro Projekt, wie oben.
MongoDB Keine Authentifizierung Eine Datenbank entsteht, sobald Ihr Code zum ersten Mal in sie schreibt.
Redis Kein Passwort Nur im Arbeitsspeicher: Ein Neustart des Dienstes leert Cache, Warteschlangen und Sitzungen.
Meilisearch Kein Master Key Entwicklungsmodus, Analytik aus.
Typesense API-Schlüssel rdev-typesense CORS ist aktiviert, sodass eine Seite auf Ihrem Laptop ihn direkt abfragen kann.
Elasticsearch Kein Benutzer und kein Passwort (Sicherheit aus) Ein einzelner Knoten mit 512 MB Arbeitsspeicher; maschinelles Lernen ist nicht enthalten.
Qdrant Kein API-Schlüssel gRPC auf dem Port nach dem HTTP-Port (6334); Telemetrie aus.
RustFS Zugriffsschlüssel rdev, geheimer Schlüssel rdev-secret Ein Bucket pro Projekt; die Webkonsole liegt auf dem nächsten Port (9001).

Im Panel zeigt Konfiguration im ⋯-Menü eines Dienstes dasselbe für die Version und den Port, die Ihr Server verwendet, samt den .env-Zeilen seines ersten Projekts, bereit zum Kopieren. Um eine Option zu ändern, verwenden Sie rdev service set (siehe unten; MySQL, MariaDB, PostgreSQL und Redis), zum Beispiel rdev service set redis appendonly yes, damit Redis-Daten Neustarts überdauern.

Eine Version wählen

Hängen Sie @ und eine Version oder Release-Linie an den Dienst an:

rdev project service shop [email protected]

Das installiert das neueste MySQL 8.0 und wechselt dorthin. Ohne Version erhalten Sie die bereits installierte oder die neueste. Um alle installierbaren Versionen zu sehen:

rdev service available

Von jedem Dienst läuft jeweils eine Version:

  • MySQL und MariaDB behalten für jede Release-Linie (8.0, 8.4, 9.7 …) getrennte Daten. Der Wechsel auf eine neuere Linie beginnt mit einer Kopie der Daten der älteren Linie, die der neuere Server aktualisiert; die Daten der älteren Linie bleiben unverändert, sodass Sie zurückwechseln können. Der Wechsel auf eine ältere Linie beginnt mit leeren Daten, weil ein älterer Server neuere Daten nicht lesen kann.
  • PostgreSQL und MongoDB behalten für jede Hauptversion getrennte Daten (PostgreSQL 14, 15 …; MongoDB 7, 8, 9). Eine neue Hauptversion beginnt leer; übertragen Sie Ihre Daten mit pg_dump oder mongodump.
  • Meilisearch und Typesense bauen ihre Indizes nach einem Versionswechsel aus Ihrer App neu auf (php artisan scout:import).

MySQL verwendet Port 3306 und MariaDB 3307, sodass beide gleichzeitig installiert sein und laufen können; Projekte erhalten den richtigen Port in ihrer .env. MariaDB verwendete vor rdev 0.2.0-beta.37 den Port 3306; setzen Sie nach diesem Update DB_PORT=3307 in der .env eines Projekts, das es verwendet, oder behalten Sie den alten Port mit rdev service set-port mariadb 3306. Die Versionswahl erfordert rdev 0.2.0-beta.18 oder neuer.

PostgreSQL-Erweiterungen

Die -full-Builds von PostgreSQL enthalten pgvector (Vektorsuche für KI-Funktionen), PostGIS und pgRouting (Karten und Routen) und ab Version 16 TimescaleDB (Zeitreihen). Wählen Sie eine anhand ihrer vollständigen Version, wie rdev service available sie auflistet:

rdev project service shop [email protected]

Aktivieren Sie die Erweiterung dann in Ihrer Datenbank, zum Beispiel in einer Migration:

CREATE EXTENSION IF NOT EXISTS vector;

Dasselbe gilt für postgis, pgrouting und timescaledb. rdev lädt TimescaleDB automatisch vor, wenn der Build es enthält.

Dienste verwalten

Die Karte Dienste auf der Seite Ihres Servers listet jeden installierten Dienst mit seiner Version, ob er läuft, seinem Port und den Projekten auf, denen Sie ihn über das Panel gegeben haben. Das Menü ⋯ in einer Zeile startet, stoppt oder startet ihn neu, installiert dieselbe Version neu (die Daten bleiben erhalten) oder deinstalliert ihn, wobei seine Daten für eine spätere Installation erhalten bleiben oder ebenfalls gelöscht werden. Eine Zeile, deren Einrichtung fehlgeschlagen ist, zeigt im selben Menü, warum, und kann erneut versucht oder aus der Liste entfernt werden. Der Server führt jede Aktion innerhalb von Sekunden aus, und die Tabelle folgt; dies erfordert rdev 0.2.0-beta.24 oder neuer auf dem Server.

Auf dem Server selbst:

Befehl Was er tut
rdev service available Listet die installierbaren Versionen auf
rdev service start mysql / stop / restart Startet, stoppt oder startet einen Dienst neu
rdev service logs mysql Zeigt die letzten Zeilen seines Logs
rdev service set-port mysql 3307 Verschiebt ihn auf einen anderen Port (beim nächsten Neustart)
rdev service set mysql max_connections 300 Setzt eine Konfigurationsoption (beim nächsten Neustart; MySQL, MariaDB, PostgreSQL und Redis)
rdev service change-version mysql 9.7.4 Wechselt auf eine andere Version
rdev service uninstall mysql 9.7.4 Entfernt eine Version; fügen Sie --purge hinzu, um auch ihre Daten zu löschen

Dienste starten mit Ihrer Umgebung. Das Entfernen eines Projekts entfernt nie dessen Datenbank; löschen Sie sie selbst, wenn Sie sie nicht mehr brauchen.

Teams und Backups

In einem Team-Tarif erreicht jede Mitgliedsumgebung die Dienste des Inhabers unter dem Namen rdev-team, neben ihren eigenen privaten (Teams).

Das nächtliche Daten-Backup in Pro und Team umfasst jede MySQL-, MariaDB-, PostgreSQL- und MongoDB-Datenbank sowie Ihren Ordner ~/Code und stellt sie über das Panel wieder her (Backups). MySQL und MariaDB werden jeweils auf ihrem eigenen Port gesichert; MongoDB als ein Archiv aller seiner Datenbanken. Suchindizes und RustFS-Buckets werden aus Ihrer App und Ihren eigenen Kopien neu aufgebaut.

Ein Dienst, der nicht auf der Liste steht

Sie müssen nicht auf uns warten, um etwas anderes auszuführen:

  • Ein in Node.js, Python, Ruby oder Go geschriebener Dienst läuft als Projekt. rdev installiert seine Laufzeit, startet den Befehl, gibt ihm einen Port und startet ihn neu, wenn er stoppt:

    rdev project add realtime --lang node --command "npx soketi start --port={port}"
    
  • Andere Software kommt in Ihren Home-Ordner, zum Beispiel ein heruntergeladenes Binary in ~/.local/bin, und startet auf dieselbe Weise über den Befehl eines Projekts. Ihr Home-Ordner ist der Teil der Umgebung, den rdev host update beibehält; alles, was anderswo mit sudo apt installiert wurde, ist nach dem nächsten Umgebungs-Update weg.

  • Möchten Sie ihn wie die obigen Dienste unterstützt haben, mit Versionen, Panel, .env-Einstellungen und Backups? Schreiben Sie uns mit dem Dienst und wofür Sie ihn nutzen. Wir fügen Dienste hinzu, die mehrere Kunden brauchen, und sagen Ihnen, wo es steht.

Ihr KI-Agent kann die ersten beiden für Sie einrichten; bitten Sie ihn, „Elasticsearch für das Projekt shop auszuführen“.