# Remote external tools settings > **TL;DR** > `File | Settings | Tools | Remote SSH External Tools` for Windows and Linux > > > > `IntelliJ IDEA | Settings | Tools | Remote SSH External Tools` for macOS > > > > `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+Alt+S` (NetBeans), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ![the Settings icon](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.settings.svg) This page describes the settings that you can configure for remote external tools. For more information about adding and using external tools, refer to [External tools](configuring-third-party-tools.html). ![The Remote SSH External Tools settings page](https://resources.jetbrains.com.cn/help/img/idea/2026.2/settings_tools_remote_external_tools.png) Use the toolbar buttons to manage the list of available external tools. Clear checkboxes for tools that you want to keep but not show in menus. ![the Add button](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.add.svg) Add `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (NetBeans), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) : Add a new external tool. ![the Remove button](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.remove.svg) Remove `Ctrl+Y` (Windows), `⌘ ⌫` (macOS), `⌘ Y` (IntelliJ IDEA Classic (macOS)), `⌘ ⌫` (macOS System Shortcuts), `Ctrl+Y` (XWin), `Ctrl+Y` (GNOME), `Ctrl+Y` (KDE), `Ctrl+Y` (Emacs), `Ctrl+Shift+K` (Sublime Text), `⌃ ⇧ K` (Sublime Text (macOS)), `Ctrl+E` (NetBeans), `Ctrl+L` (Visual Studio), `⌘ ⇧ L` (Visual Studio (macOS)), `Ctrl+D` (Eclipse), `⌘ D` (Eclipse (macOS)) : Remove the selected tool or group. ![the Edit button](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.edit.svg) Edit `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (NetBeans), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) : Edit the selected tool. ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.up.svg) Up `Alt+Up` (Windows), `⌥ ↑` (macOS), `⌥ ↑` (IntelliJ IDEA Classic (macOS)), `⌥ ↑` (macOS System Shortcuts), `Alt+Up` (XWin), `Alt+Up` (GNOME), `Alt+Up` (KDE), `Alt+Up` (Emacs), `Alt+Up` (Sublime Text), `⌥ ↑` (Sublime Text (macOS)), `Alt+Up` (NetBeans), `Alt+Up` (Visual Studio), `⌥ ↑` (Visual Studio (macOS)), `Alt+Up` (Eclipse), `⌥ ↑` (Eclipse (macOS)) : Move the selected tool up in the list. ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.down.svg) Down `Alt+Up` (Windows), `⌥ ↑` (macOS), `⌥ ↑` (IntelliJ IDEA Classic (macOS)), `⌥ ↑` (macOS System Shortcuts), `Alt+Up` (XWin), `Alt+Up` (GNOME), `Alt+Up` (KDE), `Alt+Up` (Emacs), `Alt+Up` (Sublime Text), `⌥ ↑` (Sublime Text (macOS)), `Alt+Up` (NetBeans), `Alt+Up` (Visual Studio), `⌥ ↑` (Visual Studio (macOS)), `Alt+Up` (Eclipse), `⌥ ↑` (Eclipse (macOS)) : Move the selected tool down in the list. ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.copy.svg) Copy : Move the selected tool down in the list. When you create, edit, or copy an external tool, you need to provide the tool's settings. ![Creating, editing, or copying a remote external tool](https://resources.jetbrains.com.cn/help/img/idea/2026.2/settings_tools_remote_external_tools_dialog.png) Name : The name of the tool that will be used as the action for running the tool in the IntelliJ IDEA interface. Group : The name of the group to which the tool belongs. Description : A meaningful description of the tool. ## Tool Settings > **Warning:** > Make sure that you specify the absolute paths for the tool's settings, not paths relative to the project. Program : The absolute path to the executable file (script, utility, application, and so on). Arguments : The arguments passed to the executable file, as you would specify them on the command line. : : : : : : * Use spaces to separate individual arguments. : : * Use double quotes for arguments and paths that contain spaces. : : * Use a backslash to escape double quotes that are part of the argument or path. : : : : : : For example: : : : : : : : ```PLAINTEXT : -Dmy.prop=\"quoted_value\" "second arg" third" "arg : ``` Working directory : The absolute path to the working directory from which the tool should be executed. > **Tip:** > You can use [built-in IDE macros](built-in-macros.html) to specify the name of the current file, paths relative to the project root, and other contextual information for the tool. ## Connection settings Specify the connection settings for the remote server where you want to run the tool via SSH. Current Vagrant : Run the tool on the currently running Vagrant virtual machine. For more information, refer to [Vagrant](vagrant-support.html). SSH Configuration : Run the tool on a server accessible via one of the configured [SSH configurations](create-ssh-configurations.html). Alternatively, you can choose to Select SSH configuration on every run. ## Advanced Options Synchronize files after execution : Automatically load the changes to your project files made by the external tool. If the tool does not modify any files in your project, you can disable this option. Open console for tool output : Open a console with the tool's standard output and error streams. Make console active on message in stdout : Activate the console when the tool uses the standard output stream. Make console active on message in stderr : Activate the console when the tool uses the standard error stream. Output filters : Specify filters to turn absolute file paths, line and column numbers in the output messages into hyperlinks. This will allow you to jump from the console output directly to the relevant location in the file. Each line is a regular expression that defines a separate filter. : : : : : : For example, let's say some tool produces lines of output similar to the following: : : : : : : : ```PLAINTEXT : /path/to/file.conf:42:10 WARNING: Some message : ``` : : : : : : Then you can define a filter like this one: : : : : : : : ```PLAINTEXT : $FILE_PATH$:$LINE$:$COLUMN$.* : ``` : : : : : : > **Note:** : > For these filters to work correctly, the tool must output the absolute path to the file. Line and column numbers, if it is present, must be on the same line as the file path. ## See also ### How tos [External tools](configuring-third-party-tools.html) ### Reference [External tools settings](settings-tools-external-tools.html) [Built-in IDE macros](built-in-macros.html)