Las bases de datos, cachés, búsqueda y almacenamiento de archivos se ejecutan dentro de tu entorno, junto a tus sitios. rdev instala cada servicio la primera vez que un proyecto lo necesita, en la versión que elijas, lo mantiene en marcha y escribe los ajustes de conexión en el .env del proyecto.
Qué hay disponible
| Servicio | Para qué sirve | Versiones | Puerto predeterminado |
|---|---|---|---|
| MySQL | Base de datos relacional | 8.0, 8.4, 9.7 | 3306 |
| MariaDB | Base de datos relacional | 10.11, 11.4, 11.8, 12.3 | 3307 |
| PostgreSQL | Base de datos relacional; las compilaciones -full añaden pgvector, PostGIS, pgRouting y (desde la 16) TimescaleDB |
14, 15, 16, 17, 18 | 5432 |
| MongoDB | Base de datos de documentos | 7.0, 8.0, 9.0 | 27017 |
| Redis | Caché, colas y sesiones | 9.1 | 6379 |
| Meilisearch | Búsqueda de texto completo, para Laravel Scout | 1 | 7700 |
| Typesense | Búsqueda de texto completo, para Laravel Scout | 29, 30 | 8108 |
| RustFS | Almacenamiento de archivos compatible con S3, con una consola web en el puerto siguiente | 1 | 9000 |
| Elasticsearch | Búsqueda y analítica, para drivers de Scout y clientes de Elastic (se ejecuta sin machine learning) | 8.19, 9 | 9200 |
| Qdrant | Búsqueda vectorial para funciones de IA como la búsqueda semántica | 1 | 6333 |
| Captura de correo | Captura el correo saliente para que nada llegue a bandejas de entrada reales; SMTP 127.0.0.1:2525, se consulta en el navegador en https://rdev-mail.dev.test |
integrada | |
| Servidor de volcados | Recoge los volcados de depuración de tu código; 127.0.0.1:2304, se consulta en el navegador en https://rdev-dumps.dev.test |
integrado |
Redis habla el protocolo estándar de Redis: los drivers redis de Laravel y phpredis funcionan sin cambios. Cada servicio escucha solo dentro de tu entorno, en 127.0.0.1; accede a una consola web como la de RustFS a través de tu conexión de portátil.
Correo y volcados capturados en tu navegador
Abre https://rdev-mail.dev.test en cualquier navegador de tu tailnet para leer el correo que enviaron tus apps. Verás la lista (los más recientes primero), las cabeceras de cada mensaje, sus versiones en texto plano y HTML, y sus adjuntos. Puedes borrar un mensaje o todos, y el correo nuevo aparece solo. El correo HTML se muestra con los scripts y las imágenes remotas bloqueados.
https://rdev-dumps.dev.test lista las llamadas a dump() y otros eventos capturados, los más recientes primero, con el archivo y la línea de donde vienen. Vacía la lista con Clear.
Ambas páginas se ejecutan en tu servidor y solo son accesibles a través de tu tailnet, como tus proyectos. Los datos nunca salen de tu servidor, y una vista previa nunca puede hacerlas públicas. rdev mail list imprime ambas direcciones, y la app para portátil las abre desde Mail y Dumps en la pestaña Sites. Los nombres rdev-mail y rdev-dumps están reservados, así que un proyecto no puede usarlos.
Bases de datos en tu navegador
https://rdev-adminer.dev.test abre Adminer, un gestor de bases de datos, en tu servidor. Elige MySQL o PostgreSQL, servidor 127.0.0.1, usuario root (MySQL) o postgres (PostgreSQL) y deja la contraseña vacía; para SQLite, escribe la ruta del archivo de la base de datos. Como las páginas anteriores, solo se puede abrir desde tu tailnet, y el nombre rdev-adminer está reservado. Llega con rdev 1.2.0; en un servidor instalado antes, ejecuta primero sudo rdev host update.
Dar un servicio a un proyecto
En el servidor, indica el proyecto y el servicio:
rdev project service shop postgres
rdev instala e inicia el servicio si aún no está en ejecución, crea una base de datos (MySQL, MariaDB, PostgreSQL) o un bucket (RustFS) con el nombre del proyecto, y escribe los ajustes de conexión en el .env del proyecto. Un proyecto sin .env recibe los ajustes impresos en su lugar. MongoDB crea la base de datos la primera vez que tu código escribe en ella; para un proyecto PHP rdev también instala la extensión mongodb de PHP para la versión de PHP que usa el sitio (consulta Extensiones de PHP).
Cuando un proyecto Laravel recibe una base de datos MySQL, MariaDB o PostgreSQL nueva, rdev también ejecuta php artisan migrate --force, de modo que las tablas en las que una aplicación nueva guarda sus sesiones, caché y cola existen y el sitio sigue funcionando. Solo lo hace con una base de datos que acaba de crear, que aún está vacía; una base de datos existente se deja como está. Si la migración falla, el servicio se queda en su sitio y el mensaje te dice por qué, para que ejecutes php artisan migrate tú mismo.
En el panel, abre el servidor desde Servidores en la barra lateral y elige Añadir servicio en su tarjeta Servicios, ya sea arriba o junto a un proyecto (el panel tiene el mismo botón), elige el servicio y, para los servicios con varias versiones, la Versión. La fila del proyecto muestra en qué punto está el servidor: instalando e iniciando el servicio, creando la base de datos, escribiendo el .env, ejecutando migraciones. Una notificación avisa cuando está listo. Instalar un servicio por primera vez puede tardar unos minutos. Tu agente de IA puede hacer lo mismo mediante su acceso MCP; pídele «una base de datos PostgreSQL para shop».
Un proyecto nuevo puede recibir sus servicios en el mismo comando:
rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis
Qué va en .env
| Servicio | Ajustes |
|---|---|
| MySQL, MariaDB, PostgreSQL | DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (sin contraseña: solo tu entorno puede acceder) |
| MongoDB | MONGODB_URI, MONGODB_DATABASE, para el paquete 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) y ELASTIC_HOST (127.0.0.1:9200); sin SCOUT_DRIVER, ya que Laravel no tiene un driver de Elasticsearch integrado: defínelo para el paquete que uses |
| 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 |
Los valores que ya estén en .env para estas claves se sustituyen; las demás líneas se quedan como están.
Abrir una base de datos en una aplicación de escritorio
Puedes ver y editar tus bases de datos con cualquier aplicación de bases de datos en tu portátil, por ejemplo TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. Los servicios solo escuchan dentro de tu entorno, así que elige la opción SSH (túnel SSH) de la aplicación: el host SSH es la dirección Tailscale de tu servidor (el HostName de la entrada rdev en ~/.ssh/config), usuario dev, puerto 22 y la clave SSH con la que entra tu portátil. Después conéctate a la base de datos en 127.0.0.1 con el puerto y las credenciales de la tabla anterior. Necesitas un portátil conectado; los datos viajan por tu tailnet y nunca pasan por rdev.cloud.
¿No tienes una app a mano, o estás en el móvil o la tableta? https://rdev-adminer.dev.test abre Adminer en tu navegador (consulta la sección de Adminer más arriba).
Ajustes por defecto
Cada servicio escucha solo en 127.0.0.1 dentro de tu entorno, así que nada fuera de él puede alcanzarlos, y vienen configurados para desarrollo:
| Servicio | Credenciales | Conviene saber |
|---|---|---|
| MySQL, MariaDB | Usuario root, sin contraseña |
Cada proyecto recibe una base de datos con su nombre (my-shop pasa a ser my_shop). |
| PostgreSQL | Usuario postgres, sin contraseña (autenticación trust) |
Sin socket Unix: conéctate a 127.0.0.1. Una base de datos por proyecto, como arriba. |
| MongoDB | Sin autenticación | Una base de datos aparece la primera vez que tu código escribe en ella. |
| Redis | Sin contraseña | Se guarda solo en memoria: reiniciar el servicio vacía la caché, las colas y las sesiones. |
| Meilisearch | Sin master key | Modo de desarrollo, analítica desactivada. |
| Typesense | Clave de API rdev-typesense |
CORS está activado, así que una página en tu portátil puede consultarlo directamente. |
| Elasticsearch | Sin usuario ni contraseña (seguridad desactivada) | Un solo nodo con 512 MB de memoria; no incluye aprendizaje automático. |
| Qdrant | Sin clave de API | gRPC en el puerto siguiente al del HTTP (6334); telemetría desactivada. |
| RustFS | Clave de acceso rdev, clave secreta rdev-secret |
Un bucket por proyecto; la consola web está en el puerto siguiente (9001). |
En el panel, Configuración en el menú ⋯ de un servicio muestra lo mismo para la versión y el puerto que usa tu servidor, con las líneas de .env de su primer proyecto, listas para copiar. Para cambiar una opción, usa rdev service set (ver más abajo; MySQL, MariaDB, PostgreSQL y Redis), por ejemplo rdev service set redis appendonly yes para conservar los datos de Redis entre reinicios.
Elegir una versión
Añade @ y una versión o línea de versiones al servicio:
rdev project service shop [email protected]
Eso instala el MySQL 8.0 más reciente y cambia a él. Sin versión recibes la que ya está instalada, o la más reciente. Para ver todas las versiones que puedes instalar:
rdev service available
Se ejecuta una versión de cada servicio a la vez:
- MySQL y MariaDB conservan datos separados para cada línea de versiones (8.0, 8.4, 9.7…). Pasar a una línea más nueva parte de una copia de los datos de la línea anterior, que el servidor más nuevo actualiza; los datos de la línea anterior se quedan como estaban, así que puedes volver. Pasar a una línea más antigua empieza con datos vacíos, porque un servidor más antiguo no puede leer datos más nuevos.
- PostgreSQL y MongoDB conservan datos separados para cada versión mayor (PostgreSQL 14, 15…; MongoDB 7, 8, 9). Una versión mayor nueva empieza vacía; traslada tus datos con
pg_dumpomongodump. - Meilisearch y Typesense reconstruyen sus índices desde tu aplicación (
php artisan scout:import) tras un cambio de versión.
MySQL usa el puerto 3306 y MariaDB el 3307, así que ambos se pueden instalar y ejecutar a la vez; los proyectos reciben el puerto correcto en su .env. MariaDB usaba el 3306 antes de rdev 0.2.0-beta.37; después de esa actualización, define DB_PORT=3307 en el .env de un proyecto que la use, o conserva el puerto antiguo con rdev service set-port mariadb 3306. Elegir versiones requiere rdev 0.2.0-beta.18 o posterior.
Extensiones de PostgreSQL
Las compilaciones -full de PostgreSQL incluyen pgvector (búsqueda vectorial para funciones de IA), PostGIS y pgRouting (mapas y rutas) y, desde la versión 16, TimescaleDB (series temporales). Elige una por su versión completa, tal como la lista rdev service available:
rdev project service shop [email protected]
Luego activa la extensión en tu base de datos, por ejemplo en una migración:
CREATE EXTENSION IF NOT EXISTS vector;
Lo mismo vale para postgis, pgrouting y timescaledb. rdev precarga TimescaleDB automáticamente cuando la compilación la incluye.
Gestionar servicios
La tarjeta Servicios de la página de tu servidor lista cada servicio instalado con su versión, si está en ejecución, su puerto y los proyectos a los que lo diste desde el panel. El menú ⋯ de una fila lo inicia, lo detiene o lo reinicia, reinstala la misma versión (los datos se conservan), o lo desinstala, conservando sus datos para una instalación posterior o eliminándolos también. Una fila cuya configuración falló muestra el motivo en el mismo menú y se puede reintentar o quitar de la lista. El servidor lleva a cabo cada acción en unos segundos y la tabla lo sigue; esto requiere rdev 0.2.0-beta.24 o posterior en el servidor.
En el propio servidor:
| Comando | Qué hace |
|---|---|
rdev service available |
Lista las versiones que puedes instalar |
rdev service start mysql / stop / restart |
Inicia, detiene o reinicia un servicio |
rdev service logs mysql |
Muestra las últimas líneas de su registro |
rdev service set-port mysql 3307 |
Lo mueve a otro puerto (en el siguiente reinicio) |
rdev service set mysql max_connections 300 |
Define una opción de configuración (en el siguiente reinicio; MySQL, MariaDB, PostgreSQL y Redis) |
rdev service change-version mysql 9.7.4 |
Cambia a otra versión |
rdev service uninstall mysql 9.7.4 |
Quita una versión; añade --purge para eliminar también sus datos |
Los servicios arrancan con tu entorno. Quitar un proyecto nunca quita su base de datos; elimínala tú mismo cuando ya no la necesites.
Equipos y copias de seguridad
En un plan Team, cada entorno de miembro accede a los servicios del propietario con el nombre rdev-team, junto a los suyos privados (Equipos).
La copia de seguridad nocturna de datos en Pro y Team incluye todas las bases de datos MySQL, MariaDB, PostgreSQL y MongoDB y tu carpeta ~/Code, y las restaura desde el panel (Copias de seguridad). MySQL y MariaDB se copian cada una en su propio puerto; MongoDB como un único archivo de todas sus bases de datos. Los índices de búsqueda y los buckets de RustFS se reconstruyen desde tu aplicación y tus propias copias.
Un servicio que no está en la lista
No necesitas esperarnos para ejecutar otra cosa:
-
Un servicio escrito en Node.js, Python, Ruby o Go se ejecuta como un proyecto. rdev instala su entorno de ejecución, inicia el comando, le da un puerto y lo reinicia si se detiene:
rdev project add realtime --lang node --command "npx soketi start --port={port}" -
Otro software va en tu carpeta personal, por ejemplo un binario descargado en
~/.local/bin, y se inicia desde el comando de un proyecto de la misma manera. Tu carpeta personal es la parte del entorno que conservardev host update; todo lo que se instale en otro lugar consudo aptdesaparece tras la siguiente actualización del entorno. -
¿Quieres que tenga compatibilidad como los servicios anteriores, con versiones, el panel, ajustes de
.envy copias de seguridad? Escríbenos con el servicio y para qué lo usas. Añadimos los servicios que necesitan varios clientes, y te contamos en qué punto está.
Tu agente de IA puede configurar los dos primeros por ti; pídele «ejecuta Elasticsearch para el proyecto shop».