Antworten zum Einstieg

Fragen zuDwell.

Was du vor dem ersten Projekt wissen solltest: Voraussetzungen, Arbeitsablauf und Grenzen. Die Antworten beziehen sich auf den aktuellen Stand im Repository.

Einstieg und Voraussetzungen

Was übernimmt Dwell für mich?

Dwell organisiert lokale Docker-Services, Domains und Gateway-Routing über eine Projektkonfiguration. Du steuerst die Umgebung mit der CLI. Editor, Framework, Anwendungslogik und Debugging bleiben Teil deines eigenen Workflows.

Was brauche ich für die Installation?

Node.js ab Version 20.19.0, npm im PATH und Docker Desktop oder einen anderen laufenden Docker-Daemon. Dwell setzt eine funktionsfähige lokale Docker-Umgebung voraus.

Ist Dwell schon auf npm veröffentlicht?

Nein. Die README beschreibt Dwell derzeit als unveröffentlichten Pre-Beta-Release-Candidate. Du baust das Paket aus einem Repository-Checkout und installierst die erzeugte Datei. Die genauen Befehle stehen im Installationsabschnitt.

Darf ich Dwell kommerziell verwenden?

Dwell steht unter der GPLv3-Lizenz. Sie erlaubt die kommerzielle Nutzung im Alltag (z.B. für eigene Kundenprojekte). Wenn du den Dwell-Quellcode jedoch veränderst und die Software weitergibst, musst du deine Änderungen unter derselben Lizenz (Copyleft) offenlegen.

Projekt und Arbeitsablauf

Wie starte ich mein erstes Projekt?

Starte mit dwell init für die interaktive Einrichtung. Danach baust du die Services mit dwell build und startest die Umgebung mit dwell up. Die README enthält auch Beispiele für nicht-interaktive Konfigurationen.

Wo stehen Konfiguration und Laufzeitdateien?

Die Projektkonfiguration liegt in .dwell/dwell.json. Generierte Laufzeitdateien liegen in .dwell/runtime/. Das gemeinsame Gateway verwendet ~/.dwell/gateway/. Prüfe bei Änderungen die Dokumentation deiner Version.

Kann ich Dwell ohne Docker nutzen?

Nein. Docker ist die Grundlage für die lokale Umgebung. Wenn du keine Container verwenden kannst oder möchtest, brauchst du einen anderen Ansatz.

Kann ich Dwell für den Produktionsbetrieb verwenden?

Dwell ist für lokale Entwicklung gedacht. Der sichere Betrieb öffentlich erreichbarer Anwendungen, Deployment und Produktionsinfrastruktur sind separate Aufgaben.

Domains, HTTPS und Netzwerk

Welche lokale Domain verwendet mein Projekt?

Die lokale Adresse verwendet .localhost. Projektname, Laufzeitkennung und Host-Basis können getrennt konfiguriert werden. Bei aktivierter LAN-Freigabe kommen passende .local-Namen hinzu.

Warum muss mein Browser dem lokalen Zertifikat vertrauen?

Das Gateway stellt lokale HTTPS-Verbindungen bereit. Dein Browser muss den verwendeten lokalen Zertifikaten vertrauen. Zertifikatswarnungen solltest du nicht einfach übergehen; prüfe die Einrichtung und die Dokumentation für dein System.

Wie greife ich vom Smartphone auf mein Projekt zu?

Mit dwell up --lan aktivierst du die lokale Freigabe. Das andere Gerät muss im passenden lokalen Netzwerk und den .local-Namen auflösen können. Die Erreichbarkeit hängt vom Netzwerk und von der mDNS-Unterstützung ab; die Freigabe ist kein Internet-Tunnel.

Was prüfe ich, wenn ein Projekt nicht startet?

Prüfe zuerst, ob Docker läuft und die Voraussetzungen sind. dwell doctor unterstützt die Diagnose, dwell ps zeigt den Zustand und dwell logs die Ausgaben. Prüfe außerdem die Projektkonfiguration und die Dokumentation deiner Version.

Noch eine Frage offen?

Frag direkt nach.

Beschreibe dein Setup, deine Dwell-Version und die konkrete Frage. Bitte sende keine Zugangsdaten oder andere vertrauliche Informationen.