Commands
A compact everyday overview. Examples do not replace prerequisites or confirmations; complete options and failure contracts remain in the technical reference.
Use this overview
Run project commands from the project directory. Use the linked guide for the standard workflow and the technical reference for complete flags and limits.
- Examples require active roles and the stated prerequisites.
- Import and restore can change data or configuration; review their preview or confirmation.
Projects
dwell init
Create a project with roles, configuration and local directories.
dwell init my-projectdwell import
Analyze existing code; --json writes no project files.
dwell import --jsondwell build
Prepare workspace dependencies and development images.
dwell builddwell up
Start the project and perform missing preparation when needed.
dwell updwell down
Stop the project while retaining persistent data.
dwell downdwell remove
Remove runtime while keeping source. Deleting backend volumes is an explicit prompt and deletes the database.
dwell removedwell reinit
Repair metadata after a physical move; keep the slug by default.
dwell reinitdwell projects
List known projects from the local registry.
dwell projectsStatus & diagnosis
dwell ps
Inspect project runtime, process and LAN status.
dwell psdwell access
Show configured URLs without checking reachability. Explicit database queries can reveal project passwords.
dwell accessdwell doctor
Check tools, Docker, gateway and configured HTTP routes.
dwell doctordwell logs
Follow relevant logs; find available Dwell logs without an argument. Review output before sharing.
dwell logs frontenddwell plan
Preview planned actions and observed blockers without changes; no startup guarantee.
dwell plan upConfiguration
dwell config
Inspect project configuration; config opens general editing.
dwell config showdwell stack
Change roles and runtime in a stopped project; example requires a compatible backend.
dwell stack set --php 8.4dwell routing
Manage routes with ID, target, host and URL path.
dwell routing listdwell services
Inspect or toggle configured optional backend services.
dwell services listdwell paths
Move a role directory in a stopped project; this example previews only, and the target must be empty or absent.
dwell paths move backend api --dry-runData
dwell db export
Export the database as SQL without overwriting existing files.
dwell db export backups/before-update.sqldwell db import
Replace the current database from SQL after confirmation and a safety snapshot.
dwell db import backups/before-update.sqldwell db snapshot
Save a named database snapshot; use new names for further snapshots.
dwell db snapshot before-updatedwell db restore
Restore a named snapshot, replacing the current database after confirmation.
dwell db restore before-updatedwell backup
Refresh the fixed local SQL backup; unlike db export, replaces the existing backup.
dwell backupWorkflow & output
dwell handoff
Check a clone’s local readiness; transfers no data or secrets.
dwell handoffdwell artifact
Create separate production files for supported stacks; no deployment.
dwell artifactTools
dwell open
Open the primary project URL in a browser without checking running state.
dwell opendwell ssh
Open a shell in the running backend container. ssh frontend only prints its directory path.
dwell ssh backenddwell run
Run a program in an active role; the backend needs a running container.
dwell run backend -- php -vdwell watch
Start a configured backend watcher; currently Shopware only, with its PHP container running.
dwell watchdwell versions
List available stack and PHP version lines.
dwell versions listdwell version
Show the installed Dwell version; --version shows it without the CLI header.
dwell versionNext steps
Start with the projects guide or investigate a failure with troubleshooting.