Docker Toolbox: Xdebug for PhpStorm (deprecated)

orphan

Docker Toolbox: Xdebug for PhpStorm (deprecated)

Docker Toolbox was deprecated by Docker in 2020 and removed from active support. It should not be used for a new Devilbox or Xdebug debugging setup in 2026.

This page is intentionally not updated for PhpStorm 2024.3 or 2025.1 because the underlying Docker runtime is obsolete.

Use a supported host setup

Install a current Docker runtime for your host operating system and then follow the matching maintained PhpStorm guide:

• Linux: Docker on Linux: Xdebug for PhpStorm
• macOS: Docker on MacOS: Xdebug for PhpStorm
• Windows: Docker on Windows: Xdebug for PhpStorm

Why this page is not modernized

The old workflow depended on a VirtualBox machine IP and legacy Docker Machine networking. Current Devilbox documentation targets Docker Desktop on macOS and Windows, or Docker Engine on Linux.

Tip

After moving to a supported Docker runtime, keep the same PhpStorm path mapping idea: map your local project directory to /shared/httpd inside the PHP container.

Caution

Do not copy old Docker Toolbox instructions into a current Devilbox environment. Use the supported host-specific pages instead.