Databases, caches, zoeken en bestandsopslag draaien binnen je omgeving, naast je sites. rdev installeert elke service de eerste keer dat een project hem nodig heeft, in de versie die je kiest, houdt hem draaiende en schrijft de verbindingsinstellingen in de .env van het project.
Wat beschikbaar is
| Service | Waarvoor | Versies | Standaardpoort |
|---|---|---|---|
| MySQL | Relationele database | 8.0, 8.4, 9.7 | 3306 |
| MariaDB | Relationele database | 10.11, 11.4, 11.8, 12.3 | 3307 |
| PostgreSQL | Relationele database; de -full-builds voegen pgvector, PostGIS, pgRouting en (vanaf 16) TimescaleDB toe |
14, 15, 16, 17, 18 | 5432 |
| MongoDB | Documentdatabase | 7.0, 8.0, 9.0 | 27017 |
| Redis | Cache, wachtrijen en sessies | 9.1 | 6379 |
| Meilisearch | Full-text zoeken, voor Laravel Scout | 1 | 7700 |
| Typesense | Full-text zoeken, voor Laravel Scout | 29, 30 | 8108 |
| RustFS | S3-compatibele bestandsopslag, met een webconsole op de volgende poort | 1 | 9000 |
| Elasticsearch | Zoeken en analytics, voor Scout-drivers en Elastic-clients (draait zonder machine learning) | 8.19, 9 | 9200 |
| Qdrant | Vectorzoeken voor AI-functies zoals semantisch zoeken | 1 | 6333 |
| Mailopvang | Vangt uitgaande e-mail op zodat er niets in echte inboxen belandt; SMTP 127.0.0.1:2525, bekijk in de browser op https://rdev-mail.dev.test |
ingebouwd | |
| Dumpserver | Verzamelt debugdumps uit je code; 127.0.0.1:2304, bekijk in de browser op https://rdev-dumps.dev.test |
ingebouwd |
Redis spreekt het standaard Redis-protocol: de redis-drivers van Laravel en phpredis werken ongewijzigd. Elke service luistert alleen binnen je omgeving, op 127.0.0.1; bereik een webconsole zoals die van RustFS via je laptopverbinding.
Opgevangen e-mail en dumps in je browser
Open https://rdev-mail.dev.test in een willekeurige browser op je tailnet om de e-mail te lezen die je apps hebben verstuurd. Je ziet de lijst (nieuwste eerst), de headers van elk bericht, de platte-tekst- en HTML-versie en de bijlagen. Je kunt één bericht of alle berichten verwijderen, en nieuwe e-mail verschijnt vanzelf. HTML-e-mail wordt getoond met geblokkeerde scripts en externe afbeeldingen.
https://rdev-dumps.dev.test toont dump()-aanroepen en andere opgevangen gebeurtenissen, nieuwste eerst, met het bestand en de regel waar ze vandaan komen. Maak de lijst leeg met Clear.
Beide pagina's draaien op je server en zijn, net als je projecten, alleen bereikbaar via je tailnet. Gegevens verlaten je server nooit en een preview kan ze nooit openbaar maken. rdev mail list toont beide adressen, en de laptop-app opent ze via Mail en Dumps op het tabblad Sites. De namen rdev-mail en rdev-dumps zijn gereserveerd, dus een project kan ze niet gebruiken.
Databases in je browser
https://rdev-adminer.dev.test opent Adminer, een databasebeheerder, op je server. Kies MySQL of PostgreSQL, server 127.0.0.1, gebruiker root (MySQL) of postgres (PostgreSQL) en laat het wachtwoord leeg; voor SQLite vul je het pad van het databasebestand in. Net als de pagina's hierboven is hij alleen via je tailnet bereikbaar, en de naam rdev-adminer is gereserveerd. Hij komt met rdev 1.2.0; op een eerder geïnstalleerde server voer je eerst sudo rdev host update uit.
Een project een service geven
Noem op de server het project en de service:
rdev project service shop postgres
rdev installeert en start de service als ze nog niet draait, maakt een database (MySQL, MariaDB, PostgreSQL) of een bucket (RustFS) met de naam van het project aan en schrijft de verbindingsinstellingen in de .env van het project. Een project zonder .env krijgt de instellingen in plaats daarvan geprint. MongoDB maakt de database aan de eerste keer dat je code erin schrijft; voor een PHP-project installeert rdev ook de PHP-extensie mongodb voor de PHP-versie die de site gebruikt (zie PHP-extensies).
Wanneer een Laravel-project een nieuwe MySQL-, MariaDB- of PostgreSQL-database krijgt, voert rdev ook php artisan migrate --force uit, zodat de tabellen waarin een nieuwe app zijn sessies, cache en wachtrij bewaart er zijn en de site blijft werken. Het doet dit alleen voor een database die het zojuist heeft aangemaakt en die nog leeg is; een bestaande database blijft zoals ze is. Als de migratie mislukt, blijft de service staan en vertelt de melding je waarom, zodat je zelf php artisan migrate kunt uitvoeren.
Open in het paneel de server via Servers in de zijbalk en kies Service toevoegen in zijn kaart Services, bovenaan of naast een project (het dashboard heeft dezelfde knop), kies de service en, bij services met meerdere versies, de Versie. De rij van het project toont waar de server mee bezig is: de service installeren en starten, de database aanmaken, de .env schrijven, migraties uitvoeren. Een melding zegt wanneer het klaar is. Het voor het eerst installeren van een service kan een paar minuten duren. Je AI-agent kan hetzelfde doen via zijn MCP-toegang; vraag om "een PostgreSQL-database voor shop".
Een nieuw project kan zijn services in dezelfde opdracht krijgen:
rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis
Wat in .env komt
| Service | Instellingen |
|---|---|
| MySQL, MariaDB, PostgreSQL | DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (geen wachtwoord: alleen je omgeving kan erbij) |
| MongoDB | MONGODB_URI, MONGODB_DATABASE, voor het pakket 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) en ELASTIC_HOST (127.0.0.1:9200); geen SCOUT_DRIVER, omdat Laravel geen ingebouwde Elasticsearch-driver heeft: stel hem in voor het pakket dat je gebruikt |
| 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 |
Waarden die al in .env staan voor deze sleutels worden vervangen; andere regels blijven zoals ze zijn.
Een database openen in een desktop-app
Je kunt je databases bekijken en bewerken met elke database-app op je laptop, bijvoorbeeld TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. Services luisteren alleen binnen je omgeving, dus kies de optie SSH (SSH-tunnel) van de app: de SSH-host is het Tailscale-adres van je server (de HostName in de rdev-regel van ~/.ssh/config), gebruiker dev, poort 22 en de SSH-sleutel waarmee je laptop inlogt. Maak daarna verbinding met de database op 127.0.0.1 met de poort en gegevens uit de tabel hierboven. Hiervoor is een verbonden laptop nodig; de gegevens gaan over je tailnet en nooit via rdev.cloud.
Geen app bij de hand, of op een telefoon of tablet? https://rdev-adminer.dev.test opent Adminer in je browser (zie het Adminer-gedeelte hierboven).
Standaardinstellingen
Elke service luistert alleen op 127.0.0.1 binnen je omgeving, dus niets daarbuiten kan erbij, en ze zijn ingesteld voor ontwikkeling:
| Service | Inloggegevens | Goed om te weten |
|---|---|---|
| MySQL, MariaDB | Gebruiker root, geen wachtwoord |
Elk project krijgt een database met zijn naam (my-shop wordt my_shop). |
| PostgreSQL | Gebruiker postgres, geen wachtwoord (trust-authenticatie) |
Geen Unix-socket: verbind met 127.0.0.1. Een database per project, zoals hierboven. |
| MongoDB | Geen authenticatie | Een database verschijnt de eerste keer dat je code erin schrijft. |
| Redis | Geen wachtwoord | Alleen in het geheugen bewaard: een herstart van de service leegt de cache, wachtrijen en sessies. |
| Meilisearch | Geen master key | Ontwikkelmodus, analytics uit. |
| Typesense | API-sleutel rdev-typesense |
CORS staat aan, dus een pagina op je laptop kan het rechtstreeks bevragen. |
| Elasticsearch | Geen gebruiker of wachtwoord (beveiliging uit) | Eén node met 512 MB geheugen; machine learning is niet inbegrepen. |
| Qdrant | Geen API-sleutel | gRPC op de poort na de HTTP-poort (6334); telemetrie uit. |
| RustFS | Toegangssleutel rdev, geheime sleutel rdev-secret |
Een bucket per project; de webconsole staat op de volgende poort (9001). |
In het paneel toont Configuratie in het ⋯-menu van een service hetzelfde voor de versie en poort die je server draait, met de .env-regels van het eerste project, klaar om te kopiëren. Gebruik rdev service set om een optie te wijzigen (zie hieronder; MySQL, MariaDB, PostgreSQL en Redis), bijvoorbeeld rdev service set redis appendonly yes om Redis-gegevens na herstarts te behouden.
Een versie kiezen
Voeg @ en een versie of releaselijn aan de service toe:
rdev project service shop [email protected]
Dat installeert de nieuwste MySQL 8.0 en schakelt erop over. Zonder versie krijg je degene die al is geïnstalleerd, of de nieuwste. Om elke installeerbare versie te zien:
rdev service available
Van elke service draait één versie tegelijk:
- MySQL en MariaDB bewaren aparte gegevens voor elke releaselijn (8.0, 8.4, 9.7…). Overstappen naar een nieuwere lijn begint met een kopie van de gegevens van de oudere lijn, die de nieuwere server upgradet; de gegevens van de oudere lijn blijven zoals ze waren, zodat je terug kunt. Overstappen naar een oudere lijn begint met lege gegevens, omdat een oudere server nieuwere gegevens niet kan lezen.
- PostgreSQL en MongoDB bewaren aparte gegevens voor elke hoofdversie (PostgreSQL 14, 15…; MongoDB 7, 8, 9). Een nieuwe hoofdversie begint leeg; verplaats je gegevens met
pg_dumpofmongodump. - Meilisearch en Typesense bouwen hun indexen na een versiewijziging opnieuw op vanuit je app (
php artisan scout:import).
MySQL gebruikt poort 3306 en MariaDB 3307, dus beide kunnen tegelijk worden geïnstalleerd en draaien; projecten krijgen de juiste poort in hun .env. MariaDB gebruikte 3306 vóór rdev 0.2.0-beta.37; stel na die update DB_PORT=3307 in de .env van een project dat het gebruikt, of behoud de oude poort met rdev service set-port mariadb 3306. Versies kiezen vereist rdev 0.2.0-beta.18 of nieuwer.
PostgreSQL-extensies
De -full-builds van PostgreSQL bevatten pgvector (vectorzoeken voor AI-functies), PostGIS en pgRouting (kaarten en routes) en, vanaf versie 16, TimescaleDB (tijdreeksen). Kies er een met zijn volledige versie, zoals rdev service available hem toont:
rdev project service shop [email protected]
Schakel de extensie daarna in je database in, bijvoorbeeld in een migratie:
CREATE EXTENSION IF NOT EXISTS vector;
Hetzelfde geldt voor postgis, pgrouting en timescaledb. rdev laadt TimescaleDB automatisch vooraf wanneer de build het bevat.
Services beheren
De kaart Services op de pagina van je server toont elke geïnstalleerde service met zijn versie, of hij draait, zijn poort en de projecten die je hem vanuit het paneel hebt gegeven. Het menu ⋯ op een rij start, stopt of herstart hem, installeert dezelfde versie opnieuw (de gegevens blijven behouden), of verwijdert hem, waarbij de gegevens voor een latere installatie blijven staan of ook worden verwijderd. Een rij waarvan de installatie mislukte toont waarom in hetzelfde menu en kan opnieuw worden geprobeerd of uit de lijst worden verwijderd. De server voert elke actie binnen enkele seconden uit en de tabel volgt; hiervoor is rdev 0.2.0-beta.24 of nieuwer op de server nodig.
Op de server zelf:
| Opdracht | Wat ze doet |
|---|---|
rdev service available |
Toont de versies die je kunt installeren |
rdev service start mysql / stop / restart |
Start, stopt of herstart een service |
rdev service logs mysql |
Toont de laatste regels van zijn log |
rdev service set-port mysql 3307 |
Verplaatst hem naar een andere poort (bij de volgende herstart) |
rdev service set mysql max_connections 300 |
Stelt een configuratieoptie in (bij de volgende herstart; MySQL, MariaDB, PostgreSQL en Redis) |
rdev service change-version mysql 9.7.4 |
Schakelt over naar een andere versie |
rdev service uninstall mysql 9.7.4 |
Verwijdert een versie; voeg --purge toe om ook zijn gegevens te verwijderen |
Services starten met je omgeving. Het verwijderen van een project verwijdert nooit zijn database; verwijder haar zelf wanneer je haar niet meer nodig hebt.
Teams en back-ups
Bij een Team-abonnement bereikt elke ledenomgeving de services van de eigenaar onder de naam rdev-team, naast zijn eigen privéservices (Teams).
De nachtelijke gegevensback-up bij Pro en Team omvat elke MySQL-, MariaDB-, PostgreSQL- en MongoDB-database en je map ~/Code, en herstelt ze vanuit het paneel (Back-ups). MySQL en MariaDB worden elk op hun eigen poort geback-upt; MongoDB als één archief van al zijn databases. Zoekindexen en RustFS-buckets worden opnieuw opgebouwd vanuit je app en je eigen kopieën.
Een service die niet op de lijst staat
Je hoeft niet op ons te wachten om iets anders te draaien:
-
Een service geschreven in Node.js, Python, Ruby of Go draait als project. rdev installeert zijn runtime, start de opdracht, geeft hem een poort en herstart hem als hij stopt:
rdev project add realtime --lang node --command "npx soketi start --port={port}" -
Andere software komt in je thuismap, bijvoorbeeld een gedownloade binary in
~/.local/bin, en start op dezelfde manier vanuit de opdracht van een project. Je thuismap is het deel van de omgeving datrdev host updatebehoudt; alles wat elders metsudo aptis geïnstalleerd, is na de volgende omgevingsupdate weg. -
Wil je dat het wordt ondersteund zoals de bovenstaande services, met versies, het paneel,
.env-instellingen en back-ups? Schrijf ons met de service en waarvoor je hem gebruikt. We voegen services toe die meerdere klanten nodig hebben en laten je weten hoe het ervoor staat.
Je AI-agent kan de eerste twee voor je instellen; vraag hem om "Elasticsearch te draaien voor het project shop".