Installation

Hier erfährst du, welche Voraussetzungen du brauchst, wie du den aktuellen Kandidaten installierst und dein erstes Projekt startest.

Voraussetzungen

Dwell braucht Node.js, npm und einen laufenden Docker-Daemon. Prüfe zusätzlich die Anforderungen des gewählten Frontends: einzelne Stacks benötigen eine neuere Node-Version.

Node.js ≥ 20.19.0

Mindestversion für die Dwell-CLI.

npm im PATH

npm muss in deinem Terminal verfügbar sein.

Docker läuft

Docker Desktop oder ein anderer laufender Docker-Daemon.

Installation (RC)

Wechsle im Terminal in den ausgecheckten Dwell-Quellcode. Baue dort das Paket und installiere die erzeugte Datei global.

Dwell ist ein unveröffentlichter Pre-Beta-Release-Candidate. Die Installation erfolgt derzeit aus einem Repository-Checkout.

Dwell-Repository öffnen

Paket bauenbash

npm ci && npm pack

Installiert die Abhängigkeiten des Checkouts und erzeugt das lokale npm-Paket.

Global installierenbash

npm install -g ./websign-dwell-1.0.0-rc.1.tgz

Der Dateiname gehört zu 1.0.0-rc.1. Verwende bei einem anderen Stand die tatsächlich erzeugte Paketdatei.

Installation prüfenbash

dwell --help

Zeigt die CLI-Hilfe. Ist der Befehl nicht verfügbar, prüfe dein npm-Verzeichnis im PATH.

Erstes Projekt

Führe diese Befehle in deinem Arbeitsverzeichnis aus. Der Ordner „mein-projekt“ soll noch nicht mit einer anderen Anwendung belegt sein.

Projekt initialisierenbash
```
dwell init mein-projekt
```
Erstellt einen neuen Ordner. Im interaktiven Terminal wählst du Backend, Frontend und bei aktivem Backend die PHP-Version.
Projekt vorbereitenbash
```
cd mein-projekt
dwell build
```
Wechsle in den Projektordner. Dwell prüft das Setup, installiert verwaltete Abhängigkeiten und bereitet die Laufzeit vor.
Projekt startenbash
```
dwell up
```
Startet die ausgewählten Rollen und registriert die lokalen Routen im Gateway.

Lokale Domains

Ohne eigene Host-Angabe ist das neue Projekt unter mein-projekt.localhost erreichbar. Mit dwell open öffnest du die primäre Projektadresse. Ein eigener Host lässt sich unabhängig vom Projektnamen konfigurieren.

Projektadresse öffnenbash

dwell open

Netzwerk

dwell up --lan aktiviert zusätzlich die Freigabe über .local. Das funktioniert im passenden lokalen Netzwerk und hängt von mDNS, Firewall und dem verwendeten Gerät ab. Es ist kein Internet-Tunnel.

Nächste Schritte

Die folgenden Themen helfen dir, dein Projekt zu konfigurieren oder Probleme einzugrenzen. Die ausführliche technische Referenz liegt im Repository.

Umgebung prüfenbash

dwell doctor

CLI-Befehle nachlesen Projekt konfigurieren Antworten auf häufige Fragen

Quelle: aktuelle Projekt-Dokumentation