Bancos de dados, caches, busca e armazenamento de arquivos rodam dentro do seu ambiente, ao lado dos seus sites. O rdev instala cada serviço na primeira vez que um projeto precisa dele, na versão que você escolher, mantém-no em execução e grava as configurações de conexão no .env do projeto.
O que está disponível
| Serviço | Para que serve | Versões | Porta padrão |
|---|---|---|---|
| MySQL | Banco de dados relacional | 8.0, 8.4, 9.7 | 3306 |
| MariaDB | Banco de dados relacional | 10.11, 11.4, 11.8, 12.3 | 3307 |
| PostgreSQL | Banco de dados relacional; os builds -full adicionam pgvector, PostGIS, pgRouting e (a partir da 16) TimescaleDB |
14, 15, 16, 17, 18 | 5432 |
| MongoDB | Banco de dados de documentos | 7.0, 8.0, 9.0 | 27017 |
| Redis | Cache, filas e sessões | 9.1 | 6379 |
| Meilisearch | Busca em texto completo, para o Laravel Scout | 1 | 7700 |
| Typesense | Busca em texto completo, para o Laravel Scout | 29, 30 | 8108 |
| RustFS | Armazenamento de arquivos compatível com S3, com um console web na porta seguinte | 1 | 9000 |
| Elasticsearch | Busca e análise, para drivers do Scout e clientes Elastic (roda sem machine learning) | 8.19, 9 | 9200 |
| Qdrant | Busca vetorial para recursos de IA, como busca semântica | 1 | 6333 |
| Captura de e-mails | Captura os e-mails enviados para que nada chegue a caixas de entrada reais; SMTP 127.0.0.1:2525, consulte no navegador em https://rdev-mail.dev.test |
nativo | |
| Servidor de dump | Coleta dumps de depuração do seu código; 127.0.0.1:2304, consulte no navegador em https://rdev-dumps.dev.test |
nativo |
O Redis fala o protocolo padrão do Redis: os drivers redis do Laravel e o phpredis funcionam sem alterações. Todo serviço escuta apenas dentro do seu ambiente, em 127.0.0.1; acesse um console web como o do RustFS pela sua conexão do laptop.
E-mails e dumps capturados no seu navegador
Abra https://rdev-mail.dev.test em qualquer navegador da sua tailnet para ler os e-mails enviados pelos seus apps. Você vê a lista (os mais recentes primeiro), os cabeçalhos de cada mensagem, suas versões em texto simples e HTML e seus anexos. Você pode excluir uma mensagem ou todas, e os novos e-mails aparecem sozinhos. Os e-mails HTML são exibidos com scripts e imagens remotas bloqueados.
https://rdev-dumps.dev.test lista as chamadas dump() e outros eventos capturados, os mais recentes primeiro, com o arquivo e a linha de onde vieram. Limpe a lista com Clear.
As duas páginas rodam no seu servidor e só são acessíveis pela sua tailnet, como os seus projetos. Os dados nunca saem do seu servidor, e uma pré-visualização nunca pode torná-las públicas. rdev mail list imprime os dois endereços, e o app do laptop os abre em Mail e Dumps na aba Sites. Os nomes rdev-mail e rdev-dumps são reservados, então um projeto não pode usá-los.
Bases de dados no navegador
https://rdev-adminer.dev.test abre o Adminer, um gestor de bases de dados, no seu servidor. Escolha MySQL ou PostgreSQL, servidor 127.0.0.1, utilizador root (MySQL) ou postgres (PostgreSQL) e deixe a palavra-passe vazia; para SQLite, indique o caminho do ficheiro da base de dados. Tal como as páginas acima, só está acessível pela sua tailnet, e o nome rdev-adminer está reservado. Chega com o rdev 1.2.0; num servidor instalado antes, execute primeiro sudo rdev host update.
Dê um serviço a um projeto
No servidor, informe o projeto e o serviço:
rdev project service shop postgres
O rdev instala e inicia o serviço se ele ainda não estiver em execução, cria um banco de dados (MySQL, MariaDB, PostgreSQL) ou um bucket (RustFS) com o nome do projeto e grava as configurações de conexão no .env do projeto. Um projeto sem .env recebe as configurações impressas. O MongoDB cria o banco de dados na primeira vez que o seu código grava nele; para um projeto PHP, o rdev também instala a extensão mongodb do PHP para a versão do PHP que o site usa (veja Extensões do PHP).
Quando um projeto Laravel recebe um novo banco de dados MySQL, MariaDB ou PostgreSQL, o rdev também executa php artisan migrate --force, para que as tabelas em que um novo app guarda as sessões, o cache e a fila estejam lá e o site continue funcionando. Ele só faz isso para um banco de dados que acabou de criar, que ainda está vazio; um banco de dados existente é deixado como está. Se a migration falhar, o serviço permanece no lugar e a mensagem diz o motivo, para que você execute o php artisan migrate por conta própria.
No painel, abra o servidor em Servidores na barra lateral e escolha Adicionar serviço no card Serviços dele, seja no topo ou ao lado de um projeto (o painel tem o mesmo botão), escolha o serviço e, para os serviços com várias versões, a Versão. A linha do projeto mostra em que ponto o servidor está: instalando e iniciando o serviço, criando o banco de dados, gravando o .env, executando as migrations. Uma notificação avisa quando está pronto. Instalar um serviço pela primeira vez pode levar alguns minutos. O seu agente de IA pode fazer o mesmo pelo acesso MCP dele; peça "um banco de dados PostgreSQL para o shop".
Um novo projeto pode receber os serviços dele no mesmo comando:
rdev project add shop --git [email protected]:you/shop.git --service mysql --service redis
O que vai no .env
| Serviço | Configurações |
|---|---|
| MySQL, MariaDB, PostgreSQL | DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME (sem senha: somente o seu ambiente consegue alcançá-lo) |
| MongoDB | MONGODB_URI, MONGODB_DATABASE, para o pacote 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) e ELASTIC_HOST (127.0.0.1:9200); sem SCOUT_DRIVER, já que o Laravel não tem um driver nativo de Elasticsearch: defina-o para o pacote que você usa |
| 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 |
Os valores que já estão no .env para essas chaves são substituídos; as outras linhas permanecem como estão.
Abrir um banco de dados em um aplicativo de desktop
Você pode ver e editar seus bancos de dados com qualquer aplicativo de banco de dados no seu laptop, por exemplo TablePlus, TablePro, DBeaver, DataGrip, Beekeeper Studio, DBX, pgAdmin, MySQL Workbench, MongoDB Compass, Redis Insight. Os serviços escutam apenas dentro do seu ambiente, então escolha a opção SSH (túnel SSH) do aplicativo: o host SSH é o endereço Tailscale do seu servidor (o HostName da entrada rdev em ~/.ssh/config), usuário dev, porta 22 e a chave SSH com que seu laptop entra. Depois conecte-se ao banco em 127.0.0.1 com a porta e as credenciais da tabela acima. É preciso um laptop conectado; os dados trafegam pela sua tailnet e nunca passam pelo rdev.cloud.
Sem uma app à mão, ou num telemóvel ou tablet? https://rdev-adminer.dev.test abre o Adminer no navegador (veja a secção do Adminer acima).
Configurações padrão
Cada serviço escuta apenas em 127.0.0.1 dentro do seu ambiente, então nada fora dele consegue alcançá-los, e todos vêm prontos para desenvolvimento:
| Serviço | Credenciais | Vale saber |
|---|---|---|
| MySQL, MariaDB | Usuário root, sem senha |
Cada projeto recebe um banco de dados com o seu nome (my-shop vira my_shop). |
| PostgreSQL | Usuário postgres, sem senha (autenticação trust) |
Sem socket Unix: conecte-se a 127.0.0.1. Um banco de dados por projeto, como acima. |
| MongoDB | Sem autenticação | Um banco de dados aparece na primeira vez que o seu código grava nele. |
| Redis | Sem senha | Mantido apenas na memória: reiniciar o serviço esvazia o cache, as filas e as sessões. |
| Meilisearch | Sem master key | Modo de desenvolvimento, análise desativada. |
| Typesense | Chave de API rdev-typesense |
O CORS está ativado, então uma página no seu laptop pode consultá-lo diretamente. |
| Elasticsearch | Sem usuário nem senha (segurança desativada) | Um único nó com 512 MB de memória; aprendizado de máquina não está incluído. |
| Qdrant | Sem chave de API | gRPC na porta seguinte à do HTTP (6334); telemetria desativada. |
| RustFS | Chave de acesso rdev, chave secreta rdev-secret |
Um bucket por projeto; o console web fica na porta seguinte (9001). |
No painel, Configuração no menu ⋯ de um serviço mostra o mesmo para a versão e a porta que o seu servidor usa, com as linhas do .env do primeiro projeto, prontas para copiar. Para alterar uma opção, use rdev service set (veja abaixo; MySQL, MariaDB, PostgreSQL e Redis), por exemplo rdev service set redis appendonly yes para manter os dados do Redis entre reinicializações.
Escolhendo uma versão
Adicione @ e uma versão ou linha de versão ao serviço:
rdev project service shop [email protected]
Isso instala o MySQL 8.0 mais recente e muda para ele. Sem uma versão, você recebe a que já está instalada, ou a mais recente. Para ver todas as versões que você pode instalar:
rdev service available
Uma versão de cada serviço roda por vez:
- MySQL e MariaDB mantêm dados separados para cada linha de versão (8.0, 8.4, 9.7…). Migrar para uma linha mais nova começa a partir de uma cópia dos dados da linha mais antiga, que o servidor mais novo atualiza; os dados da linha mais antiga permanecem como estavam, então você pode voltar. Migrar para uma linha mais antiga começa com dados vazios, porque um servidor mais antigo não consegue ler dados mais novos.
- PostgreSQL e MongoDB mantêm dados separados para cada versão principal (PostgreSQL 14, 15…; MongoDB 7, 8, 9). Uma nova versão principal começa vazia; leve os seus dados com
pg_dumpoumongodump. - Meilisearch e Typesense reconstroem os índices a partir do seu app (
php artisan scout:import) após uma mudança de versão.
O MySQL usa a porta 3306 e o MariaDB a 3307, então ambos podem ser instalados e rodar ao mesmo tempo; os projetos recebem a porta certa no .env. O MariaDB usava a 3306 antes do rdev 0.2.0-beta.37; depois dessa atualização, defina DB_PORT=3307 no .env de um projeto que o usa, ou mantenha a porta antiga com rdev service set-port mariadb 3306. Escolher versões exige o rdev 0.2.0-beta.18 ou posterior.
Extensões do PostgreSQL
Os builds -full do PostgreSQL incluem pgvector (busca vetorial para recursos de IA), PostGIS e pgRouting (mapas e rotas) e, a partir da versão 16, TimescaleDB (séries temporais). Escolha um pela versão completa, como o rdev service available lista:
rdev project service shop [email protected]
Depois ative a extensão no seu banco de dados, por exemplo em uma migration:
CREATE EXTENSION IF NOT EXISTS vector;
O mesmo vale para postgis, pgrouting e timescaledb. O rdev pré-carrega o TimescaleDB automaticamente quando o build o inclui.
Gerenciando serviços
O card Serviços na página do seu servidor lista todos os serviços instalados com a versão, se estão em execução, a porta e os projetos que você deu a eles pelo painel. O menu ⋯ em uma linha o inicia, para ou reinicia, reinstala a mesma versão (os dados são mantidos) ou o desinstala, mantendo os dados para uma instalação posterior ou excluindo-os também. Uma linha cuja configuração falhou mostra o motivo no mesmo menu e pode ser tentada de novo ou removida da lista. O servidor executa cada ação em segundos e a tabela acompanha; isso exige o rdev 0.2.0-beta.24 ou posterior no servidor.
No próprio servidor:
| Comando | O que faz |
|---|---|
rdev service available |
Lista as versões que você pode instalar |
rdev service start mysql / stop / restart |
Inicia, para ou reinicia um serviço |
rdev service logs mysql |
Mostra as últimas linhas do log dele |
rdev service set-port mysql 3307 |
Move-o para outra porta (na próxima reinicialização) |
rdev service set mysql max_connections 300 |
Define uma opção de configuração (na próxima reinicialização; MySQL, MariaDB, PostgreSQL e Redis) |
rdev service change-version mysql 9.7.4 |
Muda para outra versão |
rdev service uninstall mysql 9.7.4 |
Remove uma versão; adicione --purge para excluir os dados dela também |
Os serviços iniciam com o seu ambiente. Remover um projeto nunca remove o banco de dados dele; exclua-o você mesmo quando não precisar mais dele.
Equipes e backups
Em um plano Team, o ambiente de cada membro alcança os serviços do proprietário pelo nome rdev-team, ao lado dos próprios serviços privados (Equipes).
O backup noturno de dados no Pro e no Team inclui todos os bancos de dados MySQL, MariaDB, PostgreSQL e MongoDB e a sua pasta ~/Code, e os restaura pelo painel (Backups). O MySQL e o MariaDB têm backup cada um na própria porta; o MongoDB como um único arquivo com todos os bancos de dados dele. Os índices de busca e os buckets do RustFS são reconstruídos a partir do seu app e das suas próprias cópias.
Um serviço que não está na lista
Você não precisa esperar por nós para executar outra coisa:
-
Um serviço escrito em Node.js, Python, Ruby ou Go roda como um projeto. O rdev instala o runtime dele, inicia o comando, dá a ele uma porta e o reinicia se ele parar:
rdev project add realtime --lang node --command "npx soketi start --port={port}" -
Outros softwares vão para a sua pasta pessoal, por exemplo um binário baixado em
~/.local/bin, e iniciam a partir do comando de um projeto do mesmo jeito. A sua pasta pessoal é a parte do ambiente que ordev host updatemantém; tudo o que for instalado em outro lugar comsudo aptsome após a próxima atualização do ambiente. -
Quer que ele seja suportado como os serviços acima, com versões, o painel, configurações do
.enve backups? Escreva para nós com o serviço e para que você o usa. Adicionamos serviços de que vários clientes precisam e avisamos em que pé está.
O seu agente de IA pode configurar os dois primeiros para você; peça a ele para "executar o Elasticsearch para o projeto shop".