Saisissez au moins deux lettres pour rechercher dans toutes les pages de la documentation.

↑ ↓ pour naviguer ↵ pour ouvrir esc pour fermer

Utiliser rdev

Services

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_dump ou mongodump.
  • 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 que rdev host update conserve ; tout ce qui est installé ailleurs avec sudo apt disparaî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 .env et 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 ».