# Start the debugger session

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/help/go/2026.3/llms.txt).

To debug a Go application, start it with a supported [run/debug configuration](run-debug-configuration.html). For a local Go build configuration, GoLand builds the application for debugging and starts Delve.

> **Note:**
> Go Test configurations with Directory scope and the go test -fuzz framework do not support debugging. For test configuration options, refer to [Go Test](go-test.html).

Each time you debug a program, the debugger session is based on a [run/debug configuration](run-debug-configuration.html).   It allows you to configure parameters and actions for launching the application. For example, you can specify to build the application every time you start a debugger session or use the previously compiled code.

Procedure:

* To debug the program from an entry point, such as the `main` function  or a test, click Run  ![Run icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.run.svg)   icon in the gutter near it and select Debug.

This will create a temporary run/debug configuration for you. After that, you can customize and save this temporary configuration if needed.  This is the quickest way to debug your program without configuring the startup parameters.

* If you already have a run/debug configuration, select it in the [run
widget](guided-tour-around-the-user-interface.html#toolbar), then click Debug or press `Shift+F9` (Windows), `⌃ D` (macOS), `⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ D` (macOS System Shortcuts), `Shift+F9` (XWin), `Shift+F9` (GNOME), `Shift+F9` (KDE), `Shift+F9` (Emacs), `Shift+F9` (Sublime Text), `⌃ D` (Sublime Text (macOS)), `F5` (VSCode), `F5` (VSCode (macOS)).

* To launch a debug session for an existing run/debug configuration from the editor, press `Alt+Shift+F9` (Windows), `⌃ ⌥ D` (macOS), `⌥ ⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ D` (macOS System Shortcuts), `Alt+Shift+F9` (XWin), `Alt+Shift+F9` (GNOME), `Alt+Shift+F9` (KDE), `Alt+Shift+F9` (Emacs), `Alt+Shift+F9` (Sublime Text), `⌃ ⌥ D` (Sublime Text (macOS)), `Alt+Shift+F9` (VSCode), `⌃ ⌥ D` (VSCode (macOS)) and select it from the menu.

Procedure: Pause and resume a debugger session

When the debugger session is running, you can pause/resume it using the buttons on the toolbar of the Debug tool window:

* To pause a debugger session, click ![the Pause button](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.pause.svg).

* To resume a debugger session, click ![the Resume button](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.resume.svg) `F9` (Windows), `⌘ ⌥ R` (macOS), `F9` (IntelliJ IDEA Classic (macOS)), `⌃ \` (macOS System Shortcuts), `F9` (XWin), `F9` (GNOME), `F9` (KDE), `F9` (Emacs), `F9` (Sublime Text), `F9` (Sublime Text (macOS)), `F5` (VSCode), `F5` (VSCode (macOS)).

> **Note:**
> After pausing, select a goroutine and a stack frame to inspect variables and [evaluate expressions](examining-suspended-program.html#evaluating-expressions). Calling functions during evaluation has additional restrictions.

Procedure: Terminate a debugger session

* Click ![the Stop button](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg) in the Debug tool window.

Alternatively, press `Ctrl+F2` (Windows), `⌘ F2` (macOS), `⌘ F2` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ .` (macOS System Shortcuts), `Ctrl+F2` (XWin), `Ctrl+F2` (GNOME), `Ctrl+2` (KDE), `Ctrl+F2` (Emacs), `Ctrl+F2` (Sublime Text), `Ctrl+F2` (Sublime Text (macOS)), `Shift+F5` (VSCode), `⇧ F5` (VSCode (macOS)) and select the process to terminate (if there are two or more of them).

## Debug multiple tasks

Procedure:

* To run or debug multiple tasks simultaneously, open the run widget menu in the toolbar and select the corresponding run/debug configurations while holding down the `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (VSCode), `Ctrl` (VSCode (macOS)) key.

For launching multiple tasks using a single run/debug configuration, refer to [Run/debug multiple targets](run-debug-multiple.html).

The Services tool window shows multiple `go build` run/debug configurations launched by a user. To hide specific configurations, such as a CLI tool, clear the checkbox for the Go Build tree item.

