Unable to get xdebug working
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 25/100
- Issue type
- Bug
- Clarity
- Needs clarification
- Activity status
- Stale
- Tech stack
- docker, php, vscode, wordpress
- Domain
- developer-experience, devops
Research direction
Start with docker-compose.yml and the VSCode debugging setup, then inspect the wordpress container's XDEBUG_CONFIG and run phpinfo() as described. Compare the observed configuration with the linked instructions. Done means remote debugging is enabled and VSCode breakpoints trigger.
Written by the indexing model from the issue text.
Description
I've followed the instructions for both my docker-compose.yml and VSCode but I'm having trouble getting XDebug to work.
I opened a shell into the wordpress docker container and verified that XDEBUG_CONFIG is set to client_host=host.docker.internal.
VSCode is listening for XDebug but none of my breakpoints are actually triggered.
Just for fun, I ran phpinfo() and it seems like remote debugging isn't turned on.

I'm assuming I'm doing something wrong but I'm not sure what.
- Dominant language
- Dockerfile
- Stars
- 27
- Forks
- 10
- PR merge metrics
- No merged PRs in 30d
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Automattic/wordpress-xdebug
-
Difficulty 3/5 1-2 days Newbie friendliness 35/100
All issues in Automattic/wordpress-xdebug
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
use-agent-os/agent-os#3314 ·
-
agentic-workflows
Difficulty 1/5 Under an hour Newbie friendliness 85/100
githubnext/rig#534 ·
-
documentation low-priority templates
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
jesseray718/openroot#87 ·
-
factory-active factory-automatic task-bug-reproduction-cannot-reproduce task-identify-harness-labels-done task-identify-issue-type-done
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
ReedClanton/NixOS#41 ·