rdev
Docs English Türkçe Log in Create account

Using rdev

Projects and sites

Every project on your server becomes a site with its own address and trusted HTTPS.

Site addresses

Each project gets https://<name>.dev.test. The certificate is trusted by your laptop, so the browser shows no warnings, and the address works anywhere your laptop is connected to your tailnet.

PHP

  • Every PHP version from 7.4 to 8.5, chosen per site.
  • Laravel and WordPress are first-class.
  • Other PHP frameworks and plain PHP projects are supported too.
  • Extensions such as mongodb and xdebug install with one command; see PHP extensions.

Other languages

Python, Ruby, Node.js and Go projects are supported from launch. No language runtime is installed by default: when you add a project in one of these languages, rdev installs the runtime it needs at that moment, and reuses it for later projects.

This keeps the environment small, and runtimes you never use do not need updates.

Databases and services

Every project can use MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense or RustFS in the version you choose, plus mail capture and a dump server. What each is for, the versions, the .env settings and how to run something that is not on the list are on Services.

Adding a project

You can add a project in three ways:

  • by asking your AI agent, which creates sites through its MCP access;
  • with the rdev command line tool on the server;
  • from the web panel.

Any folder you create in ~/Code is served at once as https://<folder>.dev.test, so cloning a PHP project there is enough.

With the command line

  • Clone a repository and serve it as a project:

    rdev project add shop --git [email protected]:you/shop.git

  • Start an empty Python project with its runtime:

    rdev project add api --lang python

  • Serve a site with another PHP version:

    rdev use shop 8.3

rdev project list shows your projects, rdev project start|stop|logs <name> controls the dev server of a non-PHP project, and rdev project remove <name> removes one (its files stay unless you add --delete-files).

From the panel

You can also add a project without opening a terminal: on the dashboard, choose Add project next to a server, give it a name and pick a type: a new Laravel app, a new WordPress site, a clone of a git repository, or an empty PHP, Node.js, Python, Ruby or Go project. The server picks the request up within about five minutes and the dashboard shows when it is ready at https://<name>.dev.test. The Added from the panel table on the dashboard lists each project and service you asked for, with its server, its status and, when something failed, the reason. rdev never connects to your server for this; your server asks for its requests.

Adding a service to a project

A project can get a service later, when it needs one:

rdev project service shop postgres

In the panel, choose Add service on a project or next to a server. Choosing a version, the .env settings and the rest are on Services.

Environment variables from the panel

To set an API key or another secret without opening a terminal, open the server from Servers in the sidebar and use Environment variables: pick the project, enter a name and a value under Add or change, and choose Encrypt and save. The server writes it into the project's .env within seconds.

Values are encrypted in your browser with your server's own key, so rdev.cloud never sees them and cannot show them later. In .env now lists only the names. To change a value, click its name: it moves to Add or change, where you type the new value. Click × on a name to remove it; removing APP_KEY or DB_ settings usually breaks the app.