> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/open-source/use-harness-open-source/gitspaces/ides/jetbrains-gateway.md).

# JetBrains Gateway Plugin

**Harness OSS Gitspaces** supports seamless and efficient remote development in **JetBrains IDEs** using **JetBrains Gateway**.

[**JetBrains Gateway**](https://www.jetbrains.com/remote-development/gateway/) is a lightweight desktop application that allows you to work remotely with **JetBrains IDEs** without downloading the full IDE. It connects to a remote server, fetches the necessary backend components, and opens your project in a **JetBrains client**.

With the [**Harness OSS Gitspaces Plugin**](https://plugins.jetbrains.com/plugin/26595-harness-oss-gitspaces), you can seamlessly access and manage your **Gitspaces** created in JetBrains IDEs. This plugin ensures smooth navigation and efficient development within your IDE.

The following JetBrains IDEs are supported for remote development:

* IntelliJ IDEA
* PyCharm
* PhpStorm
* GoLand
* CLion
* Rider
* RubyMine
* Webstorm

![](/files/UizetVOPiIyWcdLCUgh7)

### Pre-Requisites <a href="#pre-requisites" id="pre-requisites"></a>

**Install Harness OSS Gitspaces JetBrains Plugin Package**

Ensure that you have downloaded the latest version of the [**Harness OSS Gitspaces JetBrains Gateway Plugin**](https://plugins.jetbrains.com/plugin/26595-harness-oss-gitspaces) package. Follow [**these steps**](#installing-the-plugin) to install and configure the plugin.

**Install JetBrains Gateway**

Before proceeding, ensure that [**JetBrains Gateway**](https://www.jetbrains.com/remote-development/gateway/) is installed on your device.

**Recommended Gitspace Configuration**

Refer to [**this section**](/open-source/use-harness-open-source/gitspaces/ides/intellij.md#recommended-gitspace-configuration) to understand the **recommended Gitspace requirements** for optimal performance when connecting to your Gitspace in JetBrains IDEs.

### Installing the Plugin <a href="#installing-the-plugin" id="installing-the-plugin"></a>

Follow these steps to install the **Harness OSS Gitspaces Plugin**:

1. Once you've installed JetBrains Gateway, click the **settings icon** in the bottom-left corner of the application.

   <img src="https://github.com/user-attachments/assets/0d096cb6-8c08-4d6f-85da-33b2463e77f4" alt="Image" width="650">
2. Select **"Manage Providers."**

   <img src="https://github.com/user-attachments/assets/636be358-a703-4eb6-a76d-b4e70c35949e" alt="Image" width="275">
3. From the **Plugins Marketplace**, search for **Harness OSS Gitspaces**. Click **Install**. ![](/files/7pzAzWFNjWg8LxlYQdY4)
4. Once you've installed the plugin, click **"OK"** in the bottom-corner page. ![](/files/q7nY4KWy8gNAnn6sIcZg)
5. That’s it! You will now see the plugin successfully installed in your **JetBrains Gateway connections.**\
   ![](/files/wgwHXzxhWMo1hJ5xDiqH)

### Configuring the Plugin <a href="#configuring-the-plugin" id="configuring-the-plugin"></a>

Now that you've successfully installed the plugin, you can configure it in **JetBrains Gateway** using the following steps:

1. Click on **"Harness OSS Gitspaces"** from the sidebar connections.
2. You will be prompted to enter a **Token** in JetBrains Gateway. Go to your Harness Open Source Account Settings and create a token from there.\
   ![](/files/QF9D9xhJ0ZlxYSWtpVBt)
3. You will be redirected to the **Harness OSS platform** to sign in. Enter your credentials to log into your account.
4. That’s it! Once configured, you can view all your **Gitspaces** created in JetBrains IDEs directly within the **JetBrains Gateway** application. ![](/files/qspWnHGaDjKipNvgQxOa)

### Managing Your Gitspaces <a href="#managing-your-gitspaces" id="managing-your-gitspaces"></a>

You can access and manage your **Gitspaces** (only those created in JetBrains IDEs) directly within the **JetBrains Gateway** application.

#### Access Your Gitspaces <a href="#access-your-gitspaces" id="access-your-gitspaces"></a>

You can connect to your **Gitspaces** directly from the **Gateway** application:

1. **For an actively running Gitspace**, click on **"Connect."** This will connect you to your remote Gitspace within your selected IDE.
2. **For a stopped Gitspace**, clicking on **"Connect"** will redirect you to the **Harness Gitspaces UI**, where you can check its details.

![](/files/AnS5G62UzW1lDr5NF0rc)

{% hint style="info" %}
**Note:** While a Gitspace is transitioning between **started and stopped states**, its status in the application will be displayed as **"Busy."** This indicates that the Gitspace is undergoing the transition.
{% endhint %}

#### Start Your Gitspaces <a href="#start-your-gitspaces" id="start-your-gitspaces"></a>

You can start your **stopped Gitspaces** directly from **JetBrains Gateway**:

* Click the **Green Start** icon to start your Gitspace. To open your Gitspace in your preferred IDE, refer to the IDE-specific documentation. For example, here’s how you can connect to your [Gitspace in IntelliJ IDEA](/open-source/use-harness-open-source/gitspaces/ides/intellij.md#open-the-gitspace-in-intellij). ![](/files/xhWWZWc6FBMLIeHfgFTR)
* This icon will be visible **only if your Gitspace is stopped**.

#### Stop Your Gitspaces <a href="#stop-your-gitspaces" id="stop-your-gitspaces"></a>

You can stop your **active Gitspaces** directly from **JetBrains Gateway**:

* Click the **Red Stop** icon to stop it from running.\
  ![](/files/XqxMgL3AFFVqw3lA5z8q)
* This icon will be visible **only if your Gitspace is currently active**.