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

Proyectos y sitios

Cada proyecto de tu servidor se convierte en un sitio con su propia dirección y HTTPS de confianza.

Direcciones de los sitios

Cada proyecto recibe https://<name>.dev.test. El certificado es de confianza para tu portátil, así que el navegador no muestra advertencias, y la dirección funciona dondequiera que tu portátil esté conectado a tu tailnet.

PHP

  • Todas las versiones de PHP de la 7.4 a la 8.5, elegidas por sitio.
  • Laravel y WordPress son de primera clase.
  • También se admiten otros frameworks de PHP y proyectos PHP sin framework.
  • Las extensiones como mongodb y xdebug se instalan con un comando; consulta Extensiones de PHP.

Otros lenguajes

Los proyectos de Python, Ruby, Node.js, Go, .NET, Java y Flutter son compatibles. No se instala ningún entorno de ejecución de lenguaje por defecto: cuando añades un proyecto en uno de estos lenguajes, rdev instala en ese momento el entorno de ejecución que necesita, y lo reutiliza para los proyectos posteriores.

Esto mantiene pequeño el entorno, y los entornos de ejecución que nunca usas no necesitan actualizaciones.

Bases de datos y servicios

Cada proyecto puede usar MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense o RustFS en la versión que elijas, además de captura de correo y un servidor de volcados. Para qué sirve cada uno, las versiones, los ajustes de .env y cómo ejecutar algo que no está en la lista, consulta Servicios.

Añadir un proyecto

Puedes añadir un proyecto de tres maneras:

  • pidiéndoselo a tu agente de IA, que crea sitios mediante su acceso MCP;
  • con la herramienta de línea de comandos rdev en el servidor;
  • desde el panel web.

Cualquier carpeta que crees en ~/Code se sirve de inmediato como https://<folder>.dev.test, así que clonar allí un proyecto PHP es suficiente.

Recetas: empezar desde un framework

Una receta inicia un proyecto nuevo desde un framework en una carpeta ~/Code/<name> vacía: rdev instala el lenguaje, ejecuta el instalador propio del framework, establece el comando del servidor de desarrollo y sirve la aplicación en https://<name>.dev.test.

Lenguaje Recetas
PHP Laravel y WordPress (integrados), Symfony, Statamic, CodeIgniter, CakePHP, Drupal
Node.js Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (con Capacitor), Expo (React Native), NestJS, Express, un proyecto Node.js vacío
Python Django, Flask, FastAPI, un proyecto Python vacío (cada uno en su propio .venv)
Ruby Ruby on Rails, Sinatra, un proyecto Rack vacío
Go Gin, Echo, Fiber, un módulo Go vacío
.NET ASP.NET Core Web API, Blazor, una aplicación ASP.NET Core vacía
Java Spring Boot, Quarkus, Micronaut, un proyecto Java vacío
Flutter Una app de Flutter para la web, Android e iOS, con vista previa web en vivo; un servidor HTTP de Dart (shelf)

Las recetas móviles (Ionic, Expo y Flutter) ejecutan la vista previa web de la app en el servidor; las compilaciones para Android e iOS se hacen en tu portátil. Expo Go en un teléfono que esté en tu tailnet también puede abrir un proyecto de Expo directamente desde el servidor.

  • En el panel: abre el servidor en Servidores, ve a la pestaña Recetas y elige Crear proyecto en una receta, o elígela como tipo en Añadir proyecto. El proyecto aparece entonces en la pestaña Proyectos.
  • En el servidor: rdev project recipes las lista; rdev project add web --recipe nextjs inicia una.
  • Desde un agente: la herramienta MCP que añade proyectos admite un recipe, así que puedes pedir «crea un proyecto Django llamado api».

Django y Rails están configurados para aceptar direcciones *.dev.test; los servidores de desarrollo basados en Vite (Nuxt, Astro, SvelteKit) también las permiten. Las recetas vienen de un catálogo firmado por rdev, y el servidor rechaza un catálogo cuya firma no se verifica, así que los frameworks nuevos llegan sin actualizar rdev. Las recetas requieren rdev 0.2.0-beta.38 o posterior.

Con la línea de comandos

  • Clona un repositorio y sírvelo como proyecto:

    rdev project add shop --git [email protected]:you/shop.git
    
  • Inicia un proyecto Python vacío con su entorno de ejecución:

    rdev project add api --lang python
    
  • Sirve un sitio con otra versión de PHP:

    rdev use shop 8.3
    

    En el panel, haz clic en el proyecto en la columna Proyectos de la tarjeta PHP del servidor (Extensiones de PHP).

rdev project list muestra tus proyectos, rdev project start|stop|logs <name> controla el servidor de desarrollo de un proyecto que no es PHP, y rdev project remove <name> quita uno (sus archivos se quedan salvo que añadas --delete-files).

Desde el panel

También puedes añadir un proyecto sin abrir una terminal: abre el servidor en Servidores y elige Añadir en su pestaña Proyectos, o elige Añadir proyecto junto a un servidor en el panel; dale un nombre y elige un tipo: una nueva aplicación Laravel, un nuevo sitio WordPress, un clon de un repositorio git, un proyecto PHP vacío o una de las recetas. El servidor recoge la solicitud en unos cinco minutos y el panel muestra cuándo está listo en https://<name>.dev.test. La tabla Añadido desde el panel del panel lista cada proyecto y servicio que has pedido, con su servidor, su estado y, cuando algo falló, el motivo. rdev nunca se conecta a tu servidor para esto; es tu servidor quien pide sus solicitudes. Para un repositorio git también puedes elegir su lenguaje (PHP, Node.js, Python, Ruby, Go, .NET o Java); con Detectar automáticamente, el servidor lo deduce de los archivos del repositorio. Si tu elección y los archivos no coinciden, el servidor usa tu elección y lo indica en el estado del proyecto.

La pestaña Proyectos lista cada proyecto que informa el servidor, con su dirección, y los que has pedido que aún están en camino o han fallado, con el motivo.

Corregir, eliminar y alias

El menú ⋯ de un proyecto en la pestaña Proyectos:

  • Editar e intentar de nuevo (un proyecto que falló al configurarse): el formulario se abre con lo que pediste, por ejemplo la URL del repositorio o la receta. Corrígelo y envíalo de nuevo. Quitar de la lista oculta la solicitud fallida.
  • Editar y reinstalar (un proyecto en el servidor): la carpeta del proyecto se elimina y se configura de nuevo desde cero, con el tipo que elijas. Sus datos se conservan, así que el nuevo proyecto los encuentra, a menos que marques Eliminar también sus bases de datos (abajo se explica qué elimina). Haz commit y push de tu trabajo antes: los archivos que no están en git se pierden.
  • Eliminar, conservar datos elimina la carpeta del proyecto en ~/Code, su sitio y su servidor de desarrollo; sus bases de datos y los archivos del almacenamiento se quedan. Eliminar por completo, con datos también elimina los datos del proyecto: las bases de datos MySQL, MariaDB, PostgreSQL y MongoDB con su nombre (my-shop usa my_shop) y su bucket de RustFS (my-shop) con todos los archivos subidos.
  • Añadir alias da al proyecto otra dirección: el alias store hace que https://store.dev.test abra el mismo sitio, en tu portátil y en todos los dispositivos de tu tailnet. Los puntos crean subdirecciones como api.shop. Los alias se muestran bajo el proyecto; la × de uno lo elimina.

El servidor ejecuta cada acción en pocos segundos; esto requiere rdev 1.0.3 o posterior, y 1.0.4 para eliminar datos de MongoDB y RustFS. En el propio servidor, rdev domain add <name> store.dev.test añade un alias y rdev project remove <name> --delete-files elimina un proyecto creado con rdev project add (para un sitio Laravel o WordPress, elimina su carpeta).

Antes de eliminar datos, ten en cuenta lo que alcanza:

  • No se puede deshacer. La copia de seguridad nocturna de Pro y Team incluye las bases de datos, así que puedes restaurarlas desde el panel; no incluye los buckets de RustFS, así que los archivos subidos se pierden para siempre. Descarga antes lo que necesites.
  • Se rige por el nombre, no por el propietario. rdev elimina la base de datos y el bucket con el nombre del proyecto. Si el .env de otro proyecto apunta a la misma base de datos o al mismo bucket, ese proyecto también pierde sus datos.
  • Un servicio detenido conserva sus datos. rdev solo elimina en los servicios en ejecución e indica cuáles omitió; inícialos y vuelve a ejecutar la eliminación, o borra los datos tú mismo.
  • En un plan Team el entorno de cada miembro tiene sus propios servicios; eliminar un proyecto en el tuyo nunca toca los servicios compartidos del propietario.

Añadir un servicio a un proyecto

Un proyecto puede recibir un servicio más adelante, cuando lo necesite:

rdev project service shop postgres

En el panel, elige Añadir servicio en un proyecto o junto a un servidor. Elegir una versión, los ajustes de .env y el resto están en Servicios.

Variables de entorno desde el panel

Para definir una clave de API u otro secreto sin abrir una terminal, abre el servidor desde Servidores en la barra lateral y usa Variables de entorno: elige el proyecto, introduce un nombre y un valor en Añadir o cambiar, y elige Cifrar y guardar. El servidor lo escribe en el .env del proyecto en unos segundos.

Los valores se cifran en tu navegador con la clave propia de tu servidor, así que rdev.cloud nunca los ve y no puede mostrarlos después. En .env ahora lista solo los nombres. Para cambiar un valor, haz clic en su nombre: pasa a Añadir o cambiar, donde escribes el nuevo valor. Haz clic en la × de un nombre para quitarlo; quitar APP_KEY o los ajustes DB_ suele romper la aplicación.