---
title: "Debug TYPO3"
manual: "TYPO3 Core Contribution Guide"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3contribute:phpstorm-setup-xdebug"
source: "DebuggingTypo3/Index.rst"
rendered: "2026-09-26T04:50:59+00:00"
---

# Debug TYPO3 {#phpstorm-setup-xdebug}

## Debugging With PhpStorm and Xdebug {#debugging-with-phpstorm-and-xdebug}

[Watch this video on YouTube](https://www.youtube.com/watch?v=VtffB0CG1ok)

In order to configure PhpStorm with Xdebug you need to do three things:

1.  Install xdebug
1.  Configure xdebug settings in your php.ini
1.  Use the appropriate plugin in your browser
1.  Configure PhpStorm

### php.ini {#php-ini}

Example setup:

**php.ini**

```ini
xdebug.remote_enable = 1
xdebug.remote_host = localhost
xdebug.max_nesting_level = 1000
```

You should also configure the port (xdebug.remote_port) if that should differ from the default (9000).

Remember to restart your Webserver / php-fpm / Docker after you made your changes.

### Install Plugin {#install-plugin}

Install plugin "Xdebug Helper" for your browser. To start debugging, click on the bug icon and select "Debug".

### PhpStorm {#phpstorm}

-   Check `Run: Webserver Debug Validation`
-   Start `Run: Start listing for PHP Debug Connections`
-   Create some breakpoints

## More Information {#more-information}

-   [Configuring Xdebug with PhpStorm](https://www.jetbrains.com/help/phpstorm/configuring-xdebug.html#integrationWithProduct) (Jetbrains)