DokumentationBefehle

Befehle

Eine kompakte Übersicht für den Alltag. Beispiele ersetzen keine Voraussetzungen oder Bestätigungen; die vollständigen Optionen und Fehlerverträge stehen in der technischen Referenz.

So nutzt du die Übersicht

Führe projektbezogene Commands im Projektordner aus. Nutze den verlinkten Guide für den Standard-Workflow und die technische Referenz für vollständige Flags und Grenzen.

  • Beispiele gelten nur für aktive Rollen und die genannten Voraussetzungen.
  • Import und Restore können Daten oder Konfiguration ändern; prüfe die Vorschau beziehungsweise Bestätigung.

Projekte

dwell init

Neues Projekt mit Rollen, Konfiguration und lokalen Verzeichnissen anlegen.

Beispiel: initbash
dwell init mein-projekt

dwell import

Bestehenden Code analysieren; --json schreibt keine Projektdateien.

Beispiel: importbash
dwell import --json

dwell build

Workspace-Abhängigkeiten und Entwicklungsimages vorbereiten.

Beispiel: buildbash
dwell build

dwell up

Projekt starten und bei Bedarf fehlende Vorbereitung ausführen.

Beispiel: upbash
dwell up

dwell down

Projekt stoppen; persistente Daten bleiben erhalten.

Beispiel: downbash
dwell down

dwell remove

Runtime entfernen; Quellcode bleibt. Backend-Volume-Löschung ist eine bewusste Abfrage und löscht die Datenbank.

Beispiel: removebash
dwell remove

dwell reinit

Metadaten nach einem physischen Projektumzug reparieren; Slug standardmäßig behalten.

Beispiel: reinitbash
dwell reinit

dwell projects

Bekannte Projekte aus der lokalen Registry anzeigen.

Beispiel: projectsbash
dwell projects

Status & Diagnose

dwell ps

Runtime-, Prozess- und LAN-Status des Projekts ansehen.

Beispiel: psbash
dwell ps

dwell access

Konfigurierte URLs anzeigen; keine Erreichbarkeitsprüfung. Explizite DB-Abfragen können Projektpasswörter zeigen.

Beispiel: accessbash
dwell access

dwell doctor

Tools, Docker, Gateway und konfigurierte HTTP-Routen prüfen.

Beispiel: doctorbash
dwell doctor

dwell logs

Passende Logs verfolgen; ohne Argument vorhandene Dwell-Logs finden. Ausgabe vor dem Teilen prüfen.

Beispiel: logsbash
dwell logs frontend

dwell plan

Geplante Aktionen und beobachtete Blocker schreibfrei ansehen; kein Startversprechen.

Beispiel: planbash
dwell plan up

Konfiguration

dwell config

Projektkonfiguration ansehen; config öffnet die allgemeine Bearbeitung.

Beispiel: configbash
dwell config show

dwell stack

Rollen und Runtime im gestoppten Projekt ändern; Beispiel nur bei kompatiblem Backend.

Beispiel: stackbash
dwell stack set --php 8.4

dwell routing

Routen mit ID, Ziel, Host und URL-Pfad verwalten.

Beispiel: routingbash
dwell routing list

dwell services

Konfigurierte optionale Backend-Services anzeigen oder umschalten.

Beispiel: servicesbash
dwell services list

dwell paths

Rollenverzeichnis im gestoppten Projekt verschieben; Beispiel prüft nur, Ziel muss leer oder nicht vorhanden sein.

Beispiel: pathsbash
dwell paths move backend api --dry-run

Daten

dwell db export

Datenbank als SQL exportieren; vorhandene Dateien werden nicht überschrieben.

Beispiel: db exportbash
dwell db export backups/vor-update.sql

dwell db import

Aktuelle Datenbank aus SQL ersetzen, nach Bestätigung und Safety-Snapshot.

Beispiel: db importbash
dwell db import backups/vor-update.sql

dwell db snapshot

Benannten Datenbankstand sichern; neue Namen für weitere Stände verwenden.

Beispiel: db snapshotbash
dwell db snapshot vor-update

dwell db restore

Benannten Stand wiederherstellen und die aktuelle Datenbank nach Bestätigung ersetzen.

Beispiel: db restorebash
dwell db restore vor-update

dwell backup

Die feste lokale SQL-Sicherung aktualisieren; ersetzt anders als db export den vorhandenen Stand.

Beispiel: backupbash
dwell backup

Workflow & Output

dwell handoff

Lokale Bereitschaft eines Clones prüfen; kein Daten- oder Secret-Transfer.

Beispiel: handoffbash
dwell handoff

dwell artifact

Für unterstützte Stacks separate Production-Dateien erstellen; kein Deployment.

Beispiel: artifactbash
dwell artifact

Werkzeuge

dwell open

Primäre Projekt-URL im Browser öffnen; prüft den Startzustand nicht.

Beispiel: openbash
dwell open

dwell ssh

Shell im laufenden Backend-Container öffnen. ssh frontend zeigt nur den Verzeichnispfad.

Beispiel: sshbash
dwell ssh backend

dwell run

Ein Programm in einer aktiven Rolle ausführen; Backend braucht einen laufenden Container.

Beispiel: runbash
dwell run backend -- php -v

dwell watch

Konfigurierten Backend-Watcher starten; aktuell nur Shopware, mit laufendem PHP-Container.

Beispiel: watchbash
dwell watch

dwell versions

Verfügbare Stack- und PHP-Versionslinien anzeigen.

Beispiel: versionsbash
dwell versions list

dwell version

Installierte Dwell-Version anzeigen; --version zeigt sie ohne CLI-Header.

Beispiel: versionbash
dwell version

Als Nächstes

Starte mit dem Projekte-Guide oder grenze einen Fehler mit Troubleshooting ein.

Technische Referenz

Vollständiger Command-Vertrag ↗