Les bases de données, caches, la recherche et le stockage de fichiers tournent dans votre environnement, à côté de vos sites. rdev installe chaque service la première fois qu'un projet en a besoin, dans la version de votre choix, le maintient en marche et écrit les paramètres de connexion dans le .env du projet.
Ce qui est disponible
| Service | À quoi il sert | Versions | Port par défaut |
|---|---|---|---|
| MySQL | Base de données relationnelle | 8.0, 8.4, 9.7 | 3306 |
| MariaDB | Base de données relationnelle | 10.11, 11.4, 11.8, 12.3 | 3307 |
| PostgreSQL | Base de données relationnelle ; les builds -full ajoutent pgvector, PostGIS, pgRouting et (à partir de 16) TimescaleDB |
14, 15, 16, 17, 18 | 5432 |
| MongoDB | Base de données documentaire | 7.0, 8.0, 9.0 | 27017 |
| Redis | Cache, files d'attente et sessions | 9.1 | 6379 |
| Meilisearch | Recherche plein texte, pour Laravel Scout | 1 | 7700 |
| Typesense | Recherche plein texte, pour Laravel Scout | 29, 30 | 8108 |
| RustFS | Stockage de fichiers compatible S3, avec une console web sur le port suivant | 1 | 9000 |
| Elasticsearch | Recherche et analytique, pour les drivers Scout et les clients Elastic (fonctionne sans machine learning) | 8.19, 9 | 9200 |
| Qdrant | Recherche vectorielle pour des fonctionnalités d'IA comme la recherche sémantique | 1 | 6333 |
| Capture des e-mails | Intercepte les e-mails sortants pour que rien n'atteigne de vraies boîtes de réception ; SMTP 127.0.0.1:2525, à consulter dans le navigateur sur https://rdev-mail.dev.test |
intégré | |
| Serveur de dump | Collecte les dumps de débogage de votre code ; 127.0.0.1:2304, à consulter dans le navigateur sur https://rdev-dumps.dev.test |
intégré |
Redis parle le protocole Redis standard : les drivers redis de Laravel et phpredis fonctionnent sans changement. Chaque service n'écoute qu'à l'intérieur de votre environnement, sur 127.0.0.1 ; accédez à une console web comme celle de RustFS via votre connexion d'ordinateur portable.
E-mails et dumps capturés dans votre navigateur
Ouvrez https://rdev-mail.dev.test dans n'importe quel navigateur de votre tailnet pour lire les e-mails envoyés par vos applications. Vous voyez la liste (les plus récents d'abord), les en-têtes de chaque message, ses versions texte brut et HTML, et ses pièces jointes. Vous pouvez supprimer un message ou tous, et les nouveaux e-mails apparaissent d'eux-mêmes. Les e-mails HTML s'affichent avec les scripts et les images distantes bloqués.
https://rdev-dumps.dev.test liste les appels dump() et les autres événements capturés, les plus récents d'abord, avec le fichier et la ligne d'où ils viennent. Videz la liste avec Clear.
Les deux pages tournent sur votre serveur et ne sont accessibles que via votre tailnet, comme vos projets. Les données ne quittent jamais votre serveur, et un aperçu ne peut jamais les rendre publiques. rdev mail list affiche les deux adresses, et l'application pour ordinateur portable les ouvre depuis Mail et Dumps dans l'onglet Sites. Les noms rdev-mail et rdev-dumps sont réservés ; un projet ne peut donc pas les utiliser.
Les bases de données dans votre navigateur
https://rdev-adminer.dev.test ouvre Adminer, un gestionnaire de bases de données, sur votre serveur. Choisissez MySQL ou PostgreSQL, le serveur 127.0.0.1, l'utilisateur root (MySQL) ou postgres (PostgreSQL), et laissez le mot de passe vide ; pour SQLite, saisissez le chemin du fichier de la base. Comme les pages ci-dessus, il n'est accessible que depuis votre tailnet, et le nom rdev-adminer est réservé. Il arrive avec rdev 1.2.0 ; sur un serveur installé avant, lancez d'abord sudo rdev host update.
Donner un service à un projet
Sur le serveur, nommez le projet et le service :
rdev project service shop postgres
rdev installe et démarre le service s'il ne tourne pas encore, crée une base de données (MySQL, MariaDB, PostgreSQL) ou un bucket (RustFS) portant le nom du projet, et écrit les paramètres de connexion dans le .env du projet. Un projet sans .env voit les paramètres affichés à la place. MongoDB crée la base de données la première fois que votre code y écrit ; pour un projet PHP, rdev installe aussi l'extension PHP mongodb pour la version de PHP utilisée par le site (consultez Extensions PHP).
Quand un projet Laravel obtient une nouvelle base de données MySQL, MariaDB ou PostgreSQL, rdev exécute aussi php artisan migrate --force, de sorte que les tables où une nouvelle application conserve ses sessions, son cache et sa file d'attente existent et que le site continue de fonctionner. Il ne le fait que pour une base qu'il vient de créer, donc encore vide ; une base existante est laissée telle quelle. Si la migration échoue, le service reste en place et le message vous en explique la raison, afin que vous puissiez exécuter php artisan migrate vous-même.
Dans le panneau, ouvrez le serveur depuis Serveurs dans la barre latérale et choisissez Ajouter un service dans sa carte Services, en haut ou à côté d'un projet (le tableau de bord a le même bouton), choisissez le service et, pour les services à plusieurs versions, la Version. La ligne du projet indique où en est le serveur : installation et démarrage du service, création de la base de données, écriture du .env, exécution des migrations. Une notification indique quand c'est prêt. L'installation d'un service pour la première fois peut prendre quelques minutes. Votre agent IA peut faire de même via son accès MCP ; demandez-lui « une base de données PostgreSQL pour shop ».
Un nouveau projet peut obtenir ses services dans la même commande :
rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis
Ce qui va dans .env
| Service | Paramètres |
|---|---|
| MySQL, MariaDB, PostgreSQL | DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (pas de mot de passe : seul votre environnement peut y accéder) |
| MongoDB | MONGODB_URI, MONGODB_DATABASE, pour le paquet 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) et ELASTIC_HOST (127.0.0.1:9200) ; pas de SCOUT_DRIVER, car Laravel n'a pas de driver Elasticsearch intégré : définissez-le pour le paquet que vous utilisez |
| 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 |
Les valeurs déjà présentes dans .env pour ces clés sont remplacées ; les autres lignes restent telles quelles.
Ouvrir une base de données dans une application de bureau
Vous pouvez parcourir et modifier vos bases de données avec n'importe quelle application de base de données sur votre ordinateur portable, par exemple TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. Les services n'écoutent qu'à l'intérieur de votre environnement : choisissez donc l'option SSH (tunnel SSH) de l'application. L'hôte SSH est l'adresse Tailscale de votre serveur (le HostName de l'entrée rdev dans ~/.ssh/config), l'utilisateur dev, le port 22, et la clé SSH avec laquelle votre ordinateur se connecte. Connectez-vous ensuite à la base sur 127.0.0.1 avec le port et les identifiants du tableau ci-dessus. Il faut pour cela un ordinateur connecté ; les données passent par votre tailnet et jamais par rdev.cloud.
Pas d'application sous la main, ou sur un téléphone ou une tablette ? https://rdev-adminer.dev.test ouvre Adminer dans votre navigateur (voir la section Adminer plus haut).
Paramètres par défaut
Chaque service n'écoute que sur 127.0.0.1 à l'intérieur de votre environnement, donc rien d'extérieur ne peut l'atteindre, et ils sont préconfigurés pour le développement :
| Service | Identifiants | À savoir |
|---|---|---|
| MySQL, MariaDB | Utilisateur root, sans mot de passe |
Chaque projet reçoit une base de données à son nom (my-shop devient my_shop). |
| PostgreSQL | Utilisateur postgres, sans mot de passe (authentification trust) |
Pas de socket Unix : connectez-vous à 127.0.0.1. Une base de données par projet, comme ci-dessus. |
| MongoDB | Aucune authentification | Une base de données apparaît la première fois que votre code y écrit. |
| Redis | Sans mot de passe | Conservé uniquement en mémoire : redémarrer le service vide le cache, les files d'attente et les sessions. |
| Meilisearch | Pas de master key | Mode développement, analytique désactivée. |
| Typesense | Clé d'API rdev-typesense |
CORS est activé, donc une page sur votre ordinateur portable peut l'interroger directement. |
| Elasticsearch | Ni utilisateur ni mot de passe (sécurité désactivée) | Un seul nœud avec 512 Mo de mémoire ; l'apprentissage automatique n'est pas inclus. |
| Qdrant | Pas de clé d'API | gRPC sur le port qui suit le port HTTP (6334) ; télémétrie désactivée. |
| RustFS | Clé d'accès rdev, clé secrète rdev-secret |
Un bucket par projet ; la console web est sur le port suivant (9001). |
Dans le panneau, Configuration dans le menu ⋯ d'un service affiche la même chose pour la version et le port de votre serveur, avec les lignes .env de son premier projet, prêtes à copier. Pour modifier une option, utilisez rdev service set (voir ci-dessous ; MySQL, MariaDB, PostgreSQL et Redis), par exemple rdev service set redis appendonly yes pour conserver les données Redis après un redémarrage.
Choisir une version
Ajoutez @ et une version ou une ligne de version au service :
rdev project service shop [email protected]
Cela installe le dernier MySQL 8.0 et bascule dessus. Sans version, vous obtenez celle déjà installée, ou la plus récente. Pour voir toutes les versions que vous pouvez installer :
rdev service available
Une seule version de chaque service tourne à la fois :
- MySQL et MariaDB conservent des données séparées pour chaque ligne de version (8.0, 8.4, 9.7…). Passer à une ligne plus récente repart d'une copie des données de l'ancienne ligne, que le serveur plus récent met à niveau ; les données de l'ancienne ligne restent telles quelles, vous pouvez donc revenir en arrière. Passer à une ligne plus ancienne démarre avec des données vides, car un serveur plus ancien ne peut pas lire des données plus récentes.
- PostgreSQL et MongoDB conservent des données séparées pour chaque version majeure (PostgreSQL 14, 15… ; MongoDB 7, 8, 9). Une nouvelle version majeure démarre vide ; transférez vos données avec
pg_dumpoumongodump. - Meilisearch et Typesense reconstruisent leurs index depuis votre application (
php artisan scout:import) après un changement de version.
MySQL utilise le port 3306 et MariaDB 3307, les deux peuvent donc être installés et tourner en même temps ; les projets reçoivent le bon port dans leur .env. MariaDB utilisait 3306 avant rdev 0.2.0-beta.37 ; après cette mise à jour, définissez DB_PORT=3307 dans le .env d'un projet qui l'utilise, ou conservez l'ancien port avec rdev service set-port mariadb 3306. Le choix des versions nécessite rdev 0.2.0-beta.18 ou une version ultérieure.
Extensions PostgreSQL
Les builds -full de PostgreSQL incluent pgvector (recherche vectorielle pour des fonctionnalités d'IA), PostGIS et pgRouting (cartes et itinéraires) et, à partir de la version 16, TimescaleDB (séries temporelles). Choisissez-en une par sa version complète, telle que rdev service available la liste :
rdev project service shop [email protected]
Activez ensuite l'extension dans votre base de données, par exemple dans une migration :
CREATE EXTENSION IF NOT EXISTS vector;
Il en va de même pour postgis, pgrouting et timescaledb. rdev précharge automatiquement TimescaleDB quand le build l'inclut.
Gérer les services
La carte Services de la page de votre serveur liste chaque service installé avec sa version, son état de marche, son port et les projets que vous lui avez donnés depuis le panneau. Le menu ⋯ d'une ligne le démarre, l'arrête ou le redémarre, réinstalle la même version (les données sont conservées), ou le désinstalle, en conservant ses données pour une installation ultérieure ou en les supprimant aussi. Une ligne dont la configuration a échoué en indique la raison dans le même menu et peut être réessayée ou retirée de la liste. Le serveur exécute chaque action en quelques secondes et le tableau suit ; cela nécessite rdev 0.2.0-beta.24 ou une version ultérieure sur le serveur.
Sur le serveur lui-même :
| Commande | Ce qu'elle fait |
|---|---|
rdev service available |
Liste les versions que vous pouvez installer |
rdev service start mysql / stop / restart |
Démarre, arrête ou redémarre un service |
rdev service logs mysql |
Affiche les dernières lignes de son journal |
rdev service set-port mysql 3307 |
Le déplace vers un autre port (au prochain redémarrage) |
rdev service set mysql max_connections 300 |
Définit une option de configuration (au prochain redémarrage ; MySQL, MariaDB, PostgreSQL et Redis) |
rdev service change-version mysql 9.7.4 |
Bascule vers une autre version |
rdev service uninstall mysql 9.7.4 |
Supprime une version ; ajoutez --purge pour supprimer aussi ses données |
Les services démarrent avec votre environnement. Supprimer un projet ne supprime jamais sa base de données ; supprimez-la vous-même quand vous n'en avez plus besoin.
Équipes et sauvegardes
Avec une offre Team, chaque environnement de membre accède aux services du propriétaire sous le nom rdev-team, à côté de ses propres services privés (Équipes).
La sauvegarde nocturne des données avec Pro et Team inclut chaque base de données MySQL, MariaDB, PostgreSQL et MongoDB et votre dossier ~/Code, et les restaure depuis le panneau (Sauvegardes). MySQL et MariaDB sont chacun sauvegardés sur leur propre port ; MongoDB comme une seule archive de toutes ses bases de données. Les index de recherche et les buckets RustFS sont reconstruits depuis votre application et vos propres copies.
Un service qui n'est pas dans la liste
Vous n'avez pas besoin de nous attendre pour faire tourner autre chose :
-
Un service écrit en Node.js, Python, Ruby ou Go tourne comme un projet. rdev installe son runtime, démarre la commande, lui donne un port et la redémarre si elle s'arrête :
rdev project add realtime --lang node --command "npx soketi start --port={port}" -
D'autres logiciels vont dans votre dossier personnel, par exemple un binaire téléchargé dans
~/.local/bin, et démarrent de la même façon depuis la commande d'un projet. Votre dossier personnel est la partie de l'environnement querdev host updateconserve ; tout ce qui est installé ailleurs avecsudo aptdisparaît après la prochaine mise à jour de l'environnement. -
Vous le voulez pris en charge comme les services ci-dessus, avec versions, panneau, paramètres
.envet sauvegardes ? Écrivez-nous avec le service et l'usage que vous en faites. Nous ajoutons les services dont plusieurs clients ont besoin, et nous vous disons où en est la demande.
Votre agent IA peut configurer pour vous les deux premiers ; demandez-lui de « faire tourner Elasticsearch pour le projet shop ».