> 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

Connect and manage your Gitspaces with JetBrains IDEs using the 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

![](https://1570309421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwSg8m1jnnOJ6IG7TqFYn%2Fuploads%2Fgit-blob-57dd74ed971ca5fe1159dfec4ec0f8fb33c7ee67%2Fmanage-plugin-2.png?alt=media)

### 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**. ![](https://1570309421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwSg8m1jnnOJ6IG7TqFYn%2Fuploads%2Fgit-blob-6e345564ba8bdbed1b4b8131189cf3f5059b4841%2Fhoss-plugin-3.png?alt=media)
4. Once you've installed the plugin, click **"OK"** in the bottom-corner page. ![](https://1570309421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwSg8m1jnnOJ6IG7TqFYn%2Fuploads%2Fgit-blob-18c5d63c6e30d5a50c784cc5c0d0b35b07a42e77%2Fhoss-plugin-2.png?alt=media)
5. That’s it! You will now see the plugin successfully installed in your **JetBrains Gateway connections.**\
   ![](https://1570309421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwSg8m1jnnOJ6IG7TqFYn%2Fuploads%2Fgit-blob-6b3396f245343a2ce5da2c9fe868226593fbf856%2Fhoss-gitspaces-plugin.png?alt=media)

### 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.\
   ![](https://1570309421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwSg8m1jnnOJ6IG7TqFYn%2Fuploads%2Fgit-blob-a9de8a98dce41a1e72b85edb499c139db1f07c44%2Fhoss-token.png?alt=media)
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. ![](https://1570309421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwSg8m1jnnOJ6IG7TqFYn%2Fuploads%2Fgit-blob-0a13ffa9f6354d028cd5ba283d4081094181bc61%2Fconfigure-plugin-3.png?alt=media)

### 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.

![](https://1570309421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwSg8m1jnnOJ6IG7TqFYn%2Fuploads%2Fgit-blob-db1f44b491e8857d407672579942c72df5c72329%2Fconnect-plugin.png?alt=media)

{% 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). ![](https://1570309421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwSg8m1jnnOJ6IG7TqFYn%2Fuploads%2Fgit-blob-ec82bec49233d373aaef068c073e583e6673dd3f%2Fstart-gitspace-plugin.png?alt=media)
* 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.\
  ![](https://1570309421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwSg8m1jnnOJ6IG7TqFYn%2Fuploads%2Fgit-blob-3aad3fa8289880cca0abf6d3f2c9abc5f50488a0%2Fstop-gitspace-plugin.png?alt=media)
* This icon will be visible **only if your Gitspace is currently active**.

{% @harness-feedback/feedback %}