Elk project op je server wordt een site met een eigen adres en vertrouwd HTTPS.
Siteadressen
Elk project krijgt https://<name>.dev.test. Het certificaat wordt door je laptop vertrouwd, dus de browser toont geen waarschuwingen, en het adres werkt overal waar je laptop met je tailnet is verbonden.
PHP
- Elke PHP-versie van 7.4 tot 8.5, per site te kiezen.
- Laravel en WordPress zijn eersteklas.
- Andere PHP-frameworks en gewone PHP-projecten worden ook ondersteund.
- Extensies zoals
mongodbenxdebuginstalleer je met één opdracht; zie PHP-extensies.
Andere talen
Python-, Ruby-, Node.js-, Go-, .NET-, Java- en Flutter-projecten worden ondersteund. Er wordt standaard geen taalruntime geïnstalleerd: wanneer je een project in een van deze talen toevoegt, installeert rdev op dat moment de runtime die het nodig heeft en hergebruikt die voor latere projecten.
Zo blijft de omgeving klein en hoeven runtimes die je nooit gebruikt geen updates.
Databases en services
Elk project kan MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Meilisearch, Typesense of RustFS gebruiken in de versie die je kiest, plus mailopvang en een dumpserver. Waarvoor elk dient, de versies, de .env-instellingen en hoe je iets draait dat niet op de lijst staat, staan bij Services.
Een project toevoegen
Je kunt een project op drie manieren toevoegen:
- door je AI-agent te vragen, die sites aanmaakt via zijn MCP-toegang;
- met de opdrachtregeltool
rdevop de server; - vanuit het webpaneel.
Elke map die je in ~/Code aanmaakt wordt meteen geserveerd als https://<folder>.dev.test, dus het daar klonen van een PHP-project is genoeg.
Recepten: beginnen vanuit een framework
Een recept start een nieuw project vanuit een framework in een lege map ~/Code/<name>: rdev installeert de taal, voert het eigen installatieprogramma van het framework uit, stelt de opdracht van de ontwikkelserver in en serveert de app op https://<name>.dev.test.
| Taal | Recepten |
|---|---|
| PHP | Laravel en WordPress (ingebouwd), Symfony, Statamic, CodeIgniter, CakePHP, Drupal |
| Node.js | Next.js, Nuxt, Astro, SvelteKit, React, Vue, Angular, Ionic (met Capacitor), Expo (React Native), NestJS, Express, een leeg Node.js-project |
| Python | Django, Flask, FastAPI, een leeg Python-project (elk in een eigen .venv) |
| Ruby | Ruby on Rails, Sinatra, een leeg Rack-project |
| Go | Gin, Echo, Fiber, een lege Go-module |
| .NET | ASP.NET Core Web API, Blazor, een lege ASP.NET Core-app |
| Java | Spring Boot, Quarkus, Micronaut, een leeg Java-project |
| Flutter | Een Flutter-app voor web, Android en iOS, met een live webvoorvertoning; een Dart-HTTP-server (shelf) |
De mobiele recepten (Ionic, Expo en Flutter) draaien de webvoorvertoning van de app op de server; Android- en iOS-builds gebeuren op je laptop. Expo Go op een telefoon die in je tailnet zit, kan een Expo-project ook rechtstreeks vanaf de server openen.
- In het paneel: open de server onder Servers, ga naar het tabblad Recepten en kies Project aanmaken bij een recept, of kies het als type bij Project toevoegen. Het project verschijnt dan op het tabblad Projecten.
- Op de server:
rdev project recipestoont ze;rdev project add web --recipe nextjsstart er een. - Vanuit een agent: de MCP-tool die projecten toevoegt accepteert een
recipe, dus je kunt vragen "start een Django-project met de naam api".
Django en Rails zijn ingesteld om *.dev.test-adressen te accepteren; ontwikkelservers op basis van Vite (Nuxt, Astro, SvelteKit) staan ze ook toe. Recepten komen uit een door rdev ondertekende catalogus en de server weigert een catalogus waarvan de handtekening niet klopt, dus nieuwe frameworks komen zonder rdev-update. Recepten vereisen rdev 0.2.0-beta.38 of nieuwer.
Met de opdrachtregel
-
Kloon een repository en serveer hem als project:
rdev project add shop --git [email protected]:you/shop.git -
Start een leeg Python-project met zijn runtime:
rdev project add api --lang python -
Serveer een site met een andere PHP-versie:
rdev use shop 8.3Klik in het paneel op het project in de kolom Projecten van de PHP-kaart van de server (PHP-extensies).
rdev project list toont je projecten, rdev project start|stop|logs <name> bestuurt de ontwikkelserver van een niet-PHP-project en rdev project remove <name> verwijdert er een (zijn bestanden blijven staan tenzij je --delete-files toevoegt).
Vanuit het paneel
Je kunt ook een project toevoegen zonder een terminal te openen: open de server onder Servers en kies Toevoegen op het tabblad Projecten, of kies Project toevoegen naast een server op het dashboard; geef het een naam en kies een type: een nieuwe Laravel-app, een nieuwe WordPress-site, een kloon van een git-repository, een leeg PHP-project of een van de recepten. De server pakt het verzoek binnen ongeveer vijf minuten op en het dashboard toont wanneer het klaar is op https://<name>.dev.test. De tabel Toegevoegd vanuit het paneel op het dashboard toont elk project en elke service die je hebt aangevraagd, met zijn server, zijn status en, wanneer er iets mislukte, de reden. rdev verbindt hiervoor nooit met je server; je server vraagt zelf om zijn verzoeken. Voor een git-repository kun je ook de taal kiezen (PHP, Node.js, Python, Ruby, Go, .NET of Java); op Automatisch herkennen leidt de server die af uit de bestanden. Kloppen je keuze en de bestanden niet, dan gebruikt de server je keuze en meldt dat in de status van het project.
Het tabblad Projecten toont elk project dat de server meldt, met zijn adres, en degene die je hebt aangevraagd die nog onderweg zijn of mislukten, met de reden.
Herstellen, verwijderen en aliassen
Het menu ⋯ bij een project op het tabblad Projecten:
- Bewerken en opnieuw proberen (een project waarvan de installatie is mislukt): het formulier opent met wat je hebt aangevraagd, bijvoorbeeld de repository-URL of het recept. Corrigeer het en verstuur het opnieuw. Uit de lijst verwijderen verbergt de mislukte aanvraag.
- Bewerken en opnieuw installeren (een project op de server): de map van het project wordt verwijderd en het project wordt opnieuw van nul opgezet, met het type dat je kiest. De data blijft behouden, zodat het nieuwe project die vindt, tenzij je Ook de databases verwijderen aanvinkt (hieronder staat wat dat verwijdert). Commit en push eerst je werk: bestanden die niet in git staan, zijn weg.
- Verwijderen, data bewaren verwijdert de map van het project in
~/Code, de site en de dev-server; de databases en bestanden in de opslag blijven. Volledig verwijderen, met data verwijdert ook de data van het project: de MySQL-, MariaDB-, PostgreSQL- en MongoDB-databases met zijn naam (my-shopgebruiktmy_shop) en zijn RustFS-bucket (my-shop) met alle bestanden die erin zijn geüpload. - Alias toevoegen geeft het project een extra adres: de alias
storezorgt dathttps://store.dev.testdezelfde site opent, op je laptop en op elk apparaat in je tailnet. Punten maken subadressen zoalsapi.shop. De aliassen staan onder het project; de × bij een alias verwijdert die.
De server voert elke actie binnen enkele seconden uit; hiervoor is rdev 1.0.3 of nieuwer nodig, en 1.0.4 om MongoDB- en RustFS-data te verwijderen. Op de server zelf voegt rdev domain add <name> store.dev.test een alias toe en verwijdert rdev project remove <name> --delete-files een project dat met rdev project add is gemaakt (verwijder bij een Laravel- of WordPress-site de map).
Weet voordat je data verwijdert wat het raakt:
- Het kan niet ongedaan worden gemaakt. De nachtelijke back-up bij Pro en Team bevat de databases, dus je kunt ze herstellen via het paneel; RustFS-buckets zitten er niet in, dus geüploade bestanden zijn voorgoed weg. Download eerst wat je nodig hebt.
- Het gaat op naam, niet op eigenaar. rdev verwijdert de database en de bucket met de naam van het project. Als de
.envvan een ander project naar dezelfde database of bucket wijst, verliest dat project ook zijn data. - Een gestopte service behoudt zijn data. rdev verwijdert alleen in services die draaien en meldt welke het heeft overgeslagen; start ze en voer de verwijdering opnieuw uit, of verwijder de data zelf.
- Bij een Team-abonnement heeft de omgeving van elk lid eigen services; een project verwijderen in jouw omgeving raakt nooit de gedeelde services van de eigenaar.
Een service aan een project toevoegen
Een project kan later een service krijgen, wanneer het er een nodig heeft:
rdev project service shop postgres
Kies in het paneel Service toevoegen bij een project of naast een server. Een versie kiezen, de .env-instellingen en de rest staan bij Services.
Omgevingsvariabelen vanuit het paneel
Om een API-sleutel of een ander geheim in te stellen zonder een terminal te openen, open je de server via Servers in de zijbalk en gebruik je Omgevingsvariabelen: kies het project, voer onder Toevoegen of wijzigen een naam en een waarde in en kies Versleutelen en opslaan. De server schrijft het binnen enkele seconden in de .env van het project.
Waarden worden in je browser versleuteld met de eigen sleutel van je server, dus rdev.cloud ziet ze nooit en kan ze later niet tonen. Nu in .env toont alleen de namen. Om een waarde te wijzigen klik je op haar naam: ze verhuist naar Toevoegen of wijzigen, waar je de nieuwe waarde typt. Klik op × bij een naam om haar te verwijderen; het verwijderen van APP_KEY of DB_-instellingen maakt de app meestal kapot.