Escribe al menos dos letras para buscar en todas las páginas de la documentación.

↑ ↓ para navegar ↵ para abrir esc para cerrar

Uso de rdev

Servicios

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_dump o mongodump.
  • 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 conserva rdev host update; todo lo que se instale en otro lugar con sudo apt desaparece tras la siguiente actualización del entorno.

  • ¿Quieres que tenga compatibilidad como los servicios anteriores, con versiones, el panel, ajustes de .env y 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».