# External tools

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

Configure third-party command-line applications as external tools to run them from GoLand.

For example, your workflow may require running a specific script, code generator, analyzer, preprocessor or postprocessor, some database utility, and so on. By configuring it as an external tool, GoLand provides a dedicated action for it, which you can run from the main menu, from certain context menus, assign a shortcut to it, or run it when launching a specific run configuration.

You can use [built-in IDE macros](built-in-macros.html) to pass context-dependent command-line arguments to the tool, such as the current file or your project source path. If necessary, GoLand will print the tool's output to the console.

Procedure: Add a local external tool

This example demonstrates how to add  [OptiPNG](http://optipng.sourceforge.net)  as an external tool and use it to  optimize images in your project.

1. Press `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS)) to open settings and then select `Tools | External Tools`.

2. Click ![the Add button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) and specify the tool's settings.

![The Create Tool dialog](https://resources.jetbrains.com/help/img/idea/2026.3/go_create_external_tool.png)

For more information, refer to [External Tools](settings-tools-external-tools.html).

> **Tip:**
> Click ![the Insert Macro icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineAdd.svg) to insert a [built-in IDE macro](built-in-macros.html) with the name or path of the current file, path to the project source, and so on. This example uses `$FilePath$` and `$FileDir$`.

In our case, `OptiPNG` will be run with the `-o4 $FilePath$` arguments. You can use macros that can refer to the project name, the current file path, a path to the PHP executable, and so on. Clicking ![the Insert Macros icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineAddHover.svg)  will open the Macros dialog that lists all available macros and their values.

3. Click OK to add the tool and then apply the changes.

Procedure: Run the added local external tool

To open the selected file in the newly added  toolimage, do one of the following:

* In the main menu, go to   `Tools | External Tools | Optimize PNG` .

* Right-click a file in the  Project tool window  and select    `External Tools | Optimize PNG` from the context menu.

![Run External tool](https://resources.jetbrains.com/help/img/idea/2026.3/go_create_external_tool_run.png)

* Create a shortcut to run the tool.

Press `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS)) to open settings and then select `Keymap`.  Find the  Optimize PNG  action under the External Tools node, and assign a shortcut for it.

![Create a shortcut for an external tool](https://resources.jetbrains.com/help/img/idea/2026.3/go_create_external_tool_add_shortcut.png)

When you run the tool, the  output is displayed in the Run tool window.

Procedure: Run the added tool on a remote server

Do one of the following:

* In the main menu, go to `Tools | Remote Tools` and the name of the added remote external tool.

* Create a shortcut to run the tool.

Press `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS)) to open settings and then select `Keymap`.  Find the action with the name of your configured remote external tool, and assign a shortcut for it.

After you specify the host, port, and credentials, GoLand will connect to the server via SSH and run the `date` command, returning the output to the Run tool window in GoLand.

## Web browsers

You can use a web browser to open any file from your project. By default, it is used to preview the output of an HTML file or run and debug web applications.

Procedure: Open a file in a web browser

To open a file that is intended to be rendered by a web browser (HTML, XML, JSP, and so on), do one of the following:

* Open the file in the editor and press `Alt+F2` (Windows), `⌥ F2` (macOS), `⌥ F2` (IntelliJ IDEA Classic (macOS)), `⌥ F2` (macOS System Shortcuts), `Alt+F2` (XWin), `Alt+F2` (GNOME), `Alt+F2` (KDE), `Alt+F2` (Emacs), `Alt+F2` (Sublime Text), `Alt+F2` (Sublime Text (macOS)), `Alt+F2` (VSCode), `⌥ F2` (VSCode (macOS)).

* Right-click the file in the [Project tool window](project-tool-window.html) and select Open in Browser.

* In the main menu, go to View | Open in Browser.

* Use the browser popup in the top right part of the editor window (appears on hover). Click the browser button to open the web server file URL, or `Shift+Click` (Windows), `Shift+Click` (macOS), `Shift+Click` (IntelliJ IDEA Classic (macOS)), `Shift+Click` (macOS System Shortcuts), `Shift+Click` (XWin), `Shift+Click` (GNOME), `Shift+Click` (KDE), `Shift+Click` (Emacs), `Shift+Click` (Sublime Text), `Shift+Click` (Sublime Text (macOS)), `Shift+Click` (VSCode), `Shift+Click` (VSCode (macOS)) it to open the local file URL.

![Show in browser](https://resources.jetbrains.com/help/img/idea/2026.3/ps_editor-browser-popup.png)

The Open in Browser action is not available for other file types. However, you can still execute it using Find Action `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+P` (VSCode), `F1` (VSCode (macOS)).

Procedure: View and configure the list of browsers

> **Note:**
> By default, GoLand supports some of the most popular browsers, which are configured automatically, if available.

* In the Settings dialog (`Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS))), select Tools | Web Browsers and Preview.

![The Web Browsers page in Settings](https://resources.jetbrains.com/help/img/idea/2026.3/go_settings_tools_web_browsers.png)

If a browser was installed using a standard procedure, the alias in the Path field should point to the right location. If it does not, specify the path to the corresponding executable file.

> **Tip:**
> To add a custom browser, click ![the Add button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) and specify the browser name, family, and location of the executable file or macOS application.

Procedure: Use custom profile and settings

You can configure custom profiles for Firefox and Chrome family browsers.

1. In the Settings dialog (`Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Comma` (VSCode), `⌘ Comma` (VSCode (macOS))), select Tools | Web Browsers and Preview.

2. Select the browser in the list and click ![the Edit button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg).

* For Firefox, specify the path to the `profiles.ini` file and choose the profile to use. For more information, refer to [Firefox browser profile](http://support.mozilla.com/en-US/kb/Profiles).

* For Chrome, select Use custom user data directory and specify the location of the [user data directory](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md). You can also specify additional command-line options to use when running Chrome from GoLand. For more information, open `chrome://flags` in the Chrome address bar.

## See also

### Related

[External Tools](settings-tools-external-tools.html)  [Web Browsers and Preview](settings-tools-web-browsers.html) [Built-in IDE macros](built-in-macros.html)

