Reference

CLI commands

Run commands from the consumer project root. CONTAO_E2E_DIRECTORY overrides its workspace. For all available arguments and options:

vendor/bin/contao-e2e list
vendor/bin/contao-e2e help cache:metadata
Command Purpose
doctor Initialize and verify the project-local workspace
cache:metadata Prepare cache-key files and print cache fingerprints and roots as JSON
cache:clear Clear reusable E2E setup caches
failures:clear Clear retained failure artifacts
database:stop Stop all Docker database variants belonging to the project

cache:metadata requires the Playwright Node dependencies to have been prepared with vendor/bin/playwright-install. It does not install dependencies or access the network itself. See CI caching.

database:stop refuses to interrupt active tests unless --force is supplied. Cleanup commands act on the project's E2E workspace. See workspace layout.

Browser installation is supplied by the Playwright dependency:

vendor/bin/playwright-install --browsers

Use --with-deps --browsers on fresh Linux runners to install system dependencies as well as browser binaries.

Improve this page