Start a DDEV project environment. Initializes and configures the web server and database containers. Run from project directory or pass project name(s). Usage: ddev start [projectname ...] [flags] Flags: -a/--all, -y/--skip-confirmation, --skip-hooks For full options: ddev help start

Stop and remove the containers of a DDEV project. Non-destructive: leaves database and code intact. Run from project dir or pass project name(s). Usage: ddev stop [projectname ...] [flags] For full options (e.g. --remove-data, --snapshot): ddev help stop

Restart a DDEV project: stops then starts named project(s). Usage: ddev restart [projectname ...] [flags] Flags: -a/--all, -y/--skip-confirmation For full options: ddev help restart

Get a detailed description of a running DDEV project (name, location, URL, status, MySQL connection details, Mailpit, etc.). Aliases: describe, status, st. Usage: ddev describe [projectname] [flags] For full options: ddev help describe

List DDEV projects and their status. Shows all by default; use activeOnly for running only. Usage: ddev list [flags] Flags: -A/--active-only, -t/--type For full options: ddev help list

Import a SQL dump file into the project. Supports .sql, .sql.gz, .sql.bz2, .sql.xz, .mysql, .zip, .tgz, .tar.gz. For archives, use extractPath for path inside archive. Target DB via targetDb (default "db"). Usage: ddev import-db [project] [flags] MCP args → ddev: src → --file, targetDb → --database, extractPath → --extract-path For full options and examples: ddev help import-db

Dump a database to a file or stdout. Compression: gzip (default), bzip2, or xz. Target DB via targetDb (default "db"). Usage: ddev export-db [project] [flags] MCP args → ddev: file → -f/--file, targetDb → -d/--database, compressionType → --gzip|--bzip2|--xz For full options and examples: ddev help export-db

Display stdout logs from DDEV services (docker logs). Default: web service; use service for e.g. db. Usage: ddev logs [projectname] [flags] Flags: -s/--service (web|db), -f/--follow, --tail N For full options: ddev help logs

Create, list, restore, or cleanup database snapshots (stored in .ddev/db_snapshots). Restore with action=restore and snapshotName; use ddev snapshot restore --latest for latest. Usage: ddev snapshot [projectname...] [flags] | ddev snapshot restore [name] [flags] Actions: create (optional name), list, restore (snapshotName or --latest), cleanup. Flags: -n/--name, -l/--list, -C/--cleanup, -y/--yes, -a/--all For full options: ddev help snapshot; ddev snapshot restore --help

Execute a shell command in the container for a DDEV service. Default: web service; use service (e.g. db, redis, solr) to run in another. workdir maps to ddev --dir. Usage: ddev exec [flags] [command] [command-flags] Flags: -s/--service (default web), -d/--dir (execution directory) For full options: ddev help exec

COMMON USE CASES:

Drupal (Drush):

• "drush status" - Site status

• "drush cr" - Clear cache

• "drush uli" - Generate login link

• "drush cex" - Export config

• "drush cim" - Import config

• "drush pm:install module_name" - Install module

• "drush updb -y" - Run database updates

WordPress (WP-CLI):

• "wp cli version" - WP-CLI version

• "wp plugin list" - List plugins

• "wp plugin install akismet --activate" - Install & activate plugin

• "wp theme list" - List themes

• "wp user list" - List users

• "wp core update" - Update WordPress

• "wp cache flush" - Clear cache

• "wp search-replace old.com new.com" - Search/replace URLs

Composer:

• "composer install" - Install dependencies

• "composer update" - Update packages

• "composer require vendor/package" - Add package

• "composer show" - List installed packages

Redis:

• "redis-cli INFO" - Server info

• "redis-cli PING" - Test connection

• "redis-cli KEYS *" - List keys

• "redis-cli FLUSHALL" - Clear all caches

Solr:

• "curl http://solr:8983/solr/admin/cores?action=STATUS" - Check cores

• "curl http://solr:8983/solr/corename/select?q=:" - Query Solr

MySQL/MariaDB:

• "mysql -e 'SHOW DATABASES'" - List databases

• "mysql -e 'SHOW TABLES' db" - List tables

• "mysql -e 'SELECT VERSION()'" - Database version

Platform.sh CLI:

• "platform environment:list" - List environments

• "platform db:dump" - Export database

Node.js/npm:

• "npm install" - Install packages

• "npm run build" - Build assets

• "npm run test" - Run tests

• "node --version" - Node version

Testing Frameworks:

• "playwright test" - Run Playwright tests

• "cypress run" - Run Cypress tests

• "phpunit" - Run PHP unit tests

Other:

• "php -v" - PHP version

• "ls -la" - List files

• "cat config/sync/system.site.yml" - Read file

• "env" - Show environment variables

Dangerous commands blocked unless ALLOW_DANGEROUS_COMMANDS=true.

Stop all DDEV projects and containers (equivalent to ddev stop -a --stop-ssh-agent). Stops Mutagen daemon if running. Usage: ddev poweroff [flags] For full options: ddev help poweroff

Display the version of the DDEV binary and its components. Usage: ddev version [flags] For full options: ddev help version

Get help for any DDEV command. Returns the same output as "ddev help " or "ddev --help". Use when you need exact flags, examples, or usage for a ddev command. Usage: ddev help [command] | ddev --help Examples: command="import-db" → ddev help import-db; command="snapshot", subcommand="restore" → ddev snapshot restore --help. Leave command empty for general ddev help.

Send a simple OS notification to the user