Digite pelo menos duas letras para buscar em todas as páginas da documentação.

↑ ↓ para navegar ↵ para abrir esc para fechar

Usando o rdev

Projetos e sites

Cada projeto no seu servidor se torna um site com o próprio endereço e HTTPS confiável.

Endereços dos sites

Cada projeto recebe https://<name>.dev.test. O certificado é confiável para o seu laptop, então o navegador não mostra avisos, e o endereço funciona em qualquer lugar em que o seu laptop esteja conectado à sua tailnet.

PHP

  • Todas as versões do PHP, de 7.4 a 8.5, escolhidas por site.
  • Laravel e WordPress são cidadãos de primeira classe.
  • Outros frameworks PHP e projetos PHP simples também são suportados.
  • Extensões como mongodb e xdebug são instaladas com um comando; veja Extensões do PHP.

Outras linguagens

Projetos Python, Ruby, Node.js, Go, .NET, Java e Flutter são suportados. Nenhum runtime de linguagem é instalado por padrão: quando você adiciona um projeto em uma dessas linguagens, o rdev instala o runtime de que ele precisa naquele momento e o reutiliza nos projetos seguintes.

Isso mantém o ambiente pequeno, e os runtimes que você nunca usa não precisam de atualizações.

Bancos de dados e serviços

Todo projeto pode usar MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense ou RustFS na versão que você escolher, mais captura de e-mails e um servidor de dump. Para que serve cada um, as versões, as configurações do .env e como executar algo que não está na lista, veja Serviços.

Adicionando um projeto

Você pode adicionar um projeto de três maneiras:

  • pedindo ao seu agente de IA, que cria sites pelo acesso MCP dele;
  • com a ferramenta de linha de comando rdev no servidor;
  • pelo painel web.

Qualquer pasta que você criar em ~/Code é servida na hora como https://<folder>.dev.test, então clonar um projeto PHP ali já basta.

Recipes: começando a partir de um framework

Uma recipe inicia um novo projeto a partir de um framework em uma pasta ~/Code/<name> vazia: o rdev instala a linguagem, executa o instalador do próprio framework, define o comando do servidor de desenvolvimento e serve o app em https://<name>.dev.test.

Linguagem Recipes
PHP Laravel e WordPress (nativos), Symfony, Statamic, CodeIgniter, CakePHP, Drupal
Node.js Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (com Capacitor), Expo (React Native), NestJS, Express, um projeto Node.js vazio
Python Django, Flask, FastAPI, um projeto Python vazio (cada um no próprio .venv)
Ruby Ruby on Rails, Sinatra, um projeto Rack vazio
Go Gin, Echo, Fiber, um módulo Go vazio
.NET ASP.NET Core Web API, Blazor, um app ASP.NET Core vazio
Java Spring Boot, Quarkus, Micronaut, um projeto Java vazio
Flutter Um app Flutter para web, Android e iOS, com pré-visualização web ao vivo; um servidor HTTP em Dart (shelf)

As recipes mobile (Ionic, Expo e Flutter) executam a pré-visualização web do app no servidor; os builds para Android e iOS acontecem no seu laptop. O Expo Go em um celular que esteja na sua tailnet também pode abrir um projeto Expo direto do servidor.

  • No painel: abra o servidor em Servidores, vá para a aba Recipes e escolha Criar projeto em uma recipe, ou escolha-a como tipo em Adicionar projeto. O projeto então aparece na aba Projetos.
  • No servidor: rdev project recipes as lista; rdev project add web --recipe nextjs inicia uma.
  • Por um agente: a ferramenta MCP que adiciona projetos aceita uma recipe, então você pode pedir "inicie um projeto Django chamado api".

O Django e o Rails são configurados para aceitar endereços *.dev.test; os servidores de desenvolvimento baseados em Vite (Nuxt, Astro, SvelteKit) também os permitem. As recipes vêm de um catálogo assinado pelo rdev, e o servidor recusa um catálogo cuja assinatura não confere, então novos frameworks chegam sem uma atualização do rdev. As recipes exigem o rdev 0.2.0-beta.38 ou posterior.

Pela linha de comando

  • Clone um repositório e sirva-o como projeto:

    rdev project add shop --git [email protected]:you/shop.git
    
  • Inicie um projeto Python vazio com o runtime dele:

    rdev project add api --lang python
    
  • Sirva um site com outra versão do PHP:

    rdev use shop 8.3
    

    No painel, clique no projeto na coluna Projetos do card PHP do servidor (Extensões do PHP).

O rdev project list mostra os seus projetos, o rdev project start|stop|logs <name> controla o servidor de desenvolvimento de um projeto que não é PHP, e o rdev project remove <name> remove um (os arquivos dele permanecem, a menos que você adicione --delete-files).

Pelo painel

Você também pode adicionar um projeto sem abrir um terminal: abra o servidor em Servidores e escolha Adicionar na aba Projetos dele, ou escolha Adicionar projeto ao lado de um servidor no painel; dê um nome e escolha um tipo: um novo app Laravel, um novo site WordPress, um clone de um repositório git, um projeto PHP vazio ou uma das recipes. O servidor recebe a solicitação em cerca de cinco minutos e o painel mostra quando ele está pronto em https://<name>.dev.test. A tabela Adicionado pelo painel no painel lista cada projeto e serviço que você pediu, com o servidor, o status e, quando algo falhou, o motivo. O rdev nunca se conecta ao seu servidor para isso; o seu servidor é quem pede as solicitações. Para um repositório git você também pode escolher a linguagem (PHP, Node.js, Python, Ruby, Go, .NET ou Java); em Detectar automaticamente, o servidor descobre pelos arquivos do repositório. Se sua escolha e os arquivos não baterem, o servidor usa sua escolha e avisa no status do projeto.

A aba Projetos lista todos os projetos que o servidor informa, com o endereço deles, e os que você pediu que ainda estão a caminho ou falharam, com o motivo.

Corrigir, remover e aliases

O menu ⋯ de um projeto na aba Projetos:

  • Editar e tentar novamente (um projeto que falhou na configuração): o formulário abre com o que você pediu, por exemplo a URL do repositório ou a receita. Corrija e envie de novo. Remover da lista oculta a solicitação que falhou.
  • Editar e reinstalar (um projeto no servidor): a pasta do projeto é excluída e ele é configurado novamente do zero, com o tipo que você escolher. Os dados dele são mantidos, então o novo projeto os encontra, a menos que você marque Excluir também os bancos de dados (veja abaixo o que isso exclui). Faça commit e push do seu trabalho antes: arquivos que não estão no git são perdidos.
  • Remover, manter dados exclui a pasta do projeto em ~/Code, o site e o servidor de desenvolvimento; os bancos de dados e os arquivos no armazenamento ficam. Remover completamente, com dados também exclui os dados do projeto: os bancos de dados MySQL, MariaDB, PostgreSQL e MongoDB com o nome dele (my-shop usa my_shop) e o bucket do RustFS (my-shop) com todos os arquivos enviados a ele.
  • Adicionar alias dá ao projeto outro endereço: o alias store faz https://store.dev.test abrir o mesmo site, no seu laptop e em todos os dispositivos da sua tailnet. Pontos criam subendereços como api.shop. Os aliases aparecem sob o projeto; o × em um deles o remove.

O servidor executa cada ação em poucos segundos; isso exige o rdev 1.0.3 ou posterior, e o 1.0.4 para excluir dados do MongoDB e do RustFS. No próprio servidor, rdev domain add <name> store.dev.test adiciona um alias e rdev project remove <name> --delete-files remove um projeto criado com rdev project add (para um site Laravel ou WordPress, exclua a pasta dele).

Antes de excluir dados, saiba o que isso alcança:

  • Não pode ser desfeito. O backup noturno no Pro e no Team contém os bancos de dados, então você pode restaurá-los pelo painel; ele não contém os buckets do RustFS, então os arquivos enviados se perdem para sempre. Baixe antes o que você precisar.
  • Vale o nome, não o dono. O rdev exclui o banco de dados e o bucket com o nome do projeto. Se o .env de outro projeto aponta para o mesmo banco de dados ou bucket, esse projeto também perde seus dados.
  • Um serviço parado mantém seus dados. O rdev só exclui nos serviços em execução e informa quais pulou; inicie-os e execute a remoção de novo, ou exclua os dados você mesmo.
  • Em um plano Team, o ambiente de cada membro tem seus próprios serviços; remover um projeto no seu nunca toca nos serviços compartilhados do proprietário.

Adicionando um serviço a um projeto

Um projeto pode receber um serviço depois, quando precisar de um:

rdev project service shop postgres

No painel, escolha Adicionar serviço em um projeto ou ao lado de um servidor. Escolher uma versão, as configurações do .env e o resto estão em Serviços.

Variáveis de ambiente pelo painel

Para definir uma chave de API ou outro segredo sem abrir um terminal, abra o servidor em Servidores na barra lateral e use Variáveis de ambiente: escolha o projeto, informe um nome e um valor em Adicionar ou alterar e escolha Criptografar e salvar. O servidor o grava no .env do projeto em segundos.

Os valores são criptografados no seu navegador com a chave do seu próprio servidor, então o rdev.cloud nunca os vê e não consegue exibi-los depois. Atualmente no .env lista apenas os nomes. Para alterar um valor, clique no nome dele: ele vai para Adicionar ou alterar, onde você digita o novo valor. Clique em × em um nome para removê-lo; remover o APP_KEY ou as configurações DB_ geralmente quebra o app.