---
url: /en/workspaces/jetbrains.md
---
Cloud Native Development environments support connection via JetBrains Gateway after necessary configuration.

::: warning Note
Before using the JetBrains client, you need to customize the development environment (configure dependencies in Dockerfile). See [Prerequisites](#prerequisites) below.
:::

Supported IDEs:

* IntelliJ IDEA
* GoLand
* PyCharm
* WebStorm
* PhpStorm
* RubyMine
* CLion
* RustRover
* Rider

## Core Requirements

Whether the JetBrains entry is displayed depends on whether the development environment image meets the following conditions:

| Condition | Description |
| --- | --- |
| Install `openssh-server` | Gateway connects via SSH, must be installed |
| Install IDE to `/ide_cnb` | System automatically detects installed IDEs through this directory |

## Prerequisites

To use the JetBrains client for accessing Cloud Native Development environments, complete the following preparations:

### 1. Install JetBrains Gateway

Download and install [JetBrains Gateway](https://www.jetbrains.com/remote-development/gateway/) on your local machine (supports Mac/Windows).

### 2. Configure Dockerfile

**Get IDE download URL**: [JetBrains Products](https://www.jetbrains.com/products/) → Select IDE → **Download** → **Linux** version → Right-click **direct link** to copy URL

**Dockerfile example**:

```Dockerfile{7,10,14-57}
# .ide/Dockerfile
FROM node:22

WORKDIR /root

# Install SSH service for JetBrains Gateway/VSCode/Cursor client connections
RUN apt-get update && apt-get install -y wget unzip openssh-server

# Create /ide_cnb directory for IDE installation (this path is required for auto-detection)
RUN mkdir -p /ide_cnb

# ========== Install IDEs as needed (multiple supported, comment out unwanted ones) ==========
# GoLand
RUN wget https://download.jetbrains.com/go/goland-2025.2.5.tar.gz \
    && tar -zxvf goland-2025.2.5.tar.gz -C /ide_cnb \
    && rm goland-2025.2.5.tar.gz

# IntelliJ IDEA
RUN wget https://download.jetbrains.com/idea/ideaIU-2025.2.5.tar.gz \
    && tar -zxvf ideaIU-2025.2.5.tar.gz -C /ide_cnb \
    && rm ideaIU-2025.2.5.tar.gz

# PhpStorm
RUN wget https://download.jetbrains.com/webide/PhpStorm-2025.2.5.tar.gz \
    && tar -zxvf PhpStorm-2025.2.5.tar.gz -C /ide_cnb \
    && rm PhpStorm-2025.2.5.tar.gz

# PyCharm
RUN wget https://download.jetbrains.com/python/pycharm-2025.2.5.tar.gz \
    && tar -zxvf pycharm-2025.2.5.tar.gz -C /ide_cnb \
    && rm pycharm-2025.2.5.tar.gz


# RubyMine
RUN wget https://download.jetbrains.com/ruby/RubyMine-2025.2.5.tar.gz \
    && tar -zxvf RubyMine-2025.2.5.tar.gz -C /ide_cnb \
    && rm RubyMine-2025.2.5.tar.gz

# WebStorm
RUN wget https://download.jetbrains.com/webstorm/WebStorm-2025.2.5.tar.gz \
    && tar -zxvf WebStorm-2025.2.5.tar.gz -C /ide_cnb \
    && rm WebStorm-2025.2.5.tar.gz
# CLion
RUN wget https://download.jetbrains.com/cpp/CLion-2025.2.5.tar.gz \
    && tar -zxvf CLion-2025.2.5.tar.gz -C /ide_cnb \
    && rm CLion-2025.2.5.tar.gz

# RustRover
RUN wget https://download.jetbrains.com/rustrover/RustRover-2025.2.5.tar.gz \
    && tar -zxvf RustRover-2025.2.5.tar.gz -C /ide_cnb \
    && rm RustRover-2025.2.5.tar.gz

# Rider
RUN wget https://download.jetbrains.com/rider/JetBrains.Rider-2025.3.0.3.tar.gz \
    && tar -zxvf JetBrains.Rider-2025.3.0.3.tar.gz -C /ide_cnb \
    && rm JetBrains.Rider-2025.3.0.3.tar.gz

# ========== Optional: Install VSCode WebIDE ==========

RUN curl -fsSL https://code-server.dev/install.sh | sh \
    && code-server --install-extension cnbcool.cnb-welcome \
    && code-server --install-extension redhat.vscode-yaml \
    && code-server --install-extension orta.vscode-jest \
    && code-server --install-extension dbaeumer.vscode-eslint \
    && code-server --install-extension waderyan.gitblame \
    && code-server --install-extension mhutchie.git-graph \
    && code-server --install-extension donjayamanne.githistory

ENV LANG C.UTF-8
```

## Access Development Environment

After the environment is created, click the **JetBrains** button to open Gateway connection.

Entry points:

* **Launch page**: IDE entry selection page appears after clicking "Start Cloud Native Development" and environment creation succeeds
* **Environment list**: Avatar → My Cloud Native Development
* **Branch list**: Button on the right side of branches with existing environments opens IDE entry selection page

## FAQ

| Symptom | Possible Cause |
| --- | --- |
| JetBrains button not displayed | IDE not installed to `/ide_cnb` directory |
| Gateway connection failed | `openssh-server` not installed in image |
| Cannot open locally | JetBrains Gateway not installed |

## Advanced

The above process is sufficient for normal use of JetBrains IDE with Cloud Native Development environments. For customizing the cloud development environment startup process, see [Custom Environment Creation Process](./custom-dev-pipeline.md).