Skip to content

WebDev

Local Development Environments for PHP based Applications using DevContainer.

WebDev extends Dev Containers with a CLI so you can switch PHP and Node versions, run tasks, manage secrets, and work with multiple repos in one environment — without learning Docker.

Simple CLI

No need to remember shell scripts or arguments. Run webdev to see available commands and what they do.

PHP & Node versions

Switch PHP and Node versions with a single command. Configure versions and extensions in one place.

Tasks & automation

Define tasks that run during setup — install Composer packages, compile themes, and more.

Secrets

Define required secrets like auth.json for composer oder registry credentials once and use it for multiple projects.

Secrets & services

Activate Mailhog, PHPMyAdmin, PHPCacheAdmin, etc. without manual setup. Easily add any additional services.

Multiple workspaces

Use several repositories in one dev environment. Ideal for apps that combine CMS, custom backend, and frontend.

IDE-friendly

Works with VS Code, Cursor, Windsurf, and other IDEs that support Dev Containers. Open the project and go.

  • Developers — Focus on code, not Docker. Get a consistent stack (PHP, Node, DB, services) and switch versions or run scripts via the CLI.
  • Teams — Same setup everywhere. One config file defines the environment; everyone gets the same tools and versions.
  • Dev Container users — You already use containers.dev. WebDev adds a CLI for version switching, tasks, secrets, and multi-repo workspaces.

There are different base images for various purposes. The source code for them can be found here

ImageDescription
ghcr.io/derroylo/devcontainer-prebuilds/php:latestBase image for PHP Development
ghcr.io/derroylo/devcontainer-prebuilds/symfony:latestBase image for Symfony Development. Includes the Symfony CLI additionally to the php image
ghcr.io/derroylo/devcontainer-prebuilds/shopware:latestBase image for Shopware Development. Includes the Shopware CLI additionally to the php image
ghcr.io/derroylo/devcontainer-prebuilds/oxid-1_10:latestBase image for Oxid Development. Uses composer 1.10.
ghcr.io/derroylo/devcontainer-prebuilds/oxid-2_2:latestBase image for Oxid Development. Uses composer 2.2.
ghcr.io/derroylo/devcontainer-prebuilds/oxid-2_7:latestBase image for Oxid Development. Uses composer 2.7.

Read the docs · CLI reference · GitHub