Skip to main content
Ona integrates with JetBrains IDEs through JetBrains Toolbox and the Ona plugin. Supported IDEs: IntelliJ IDEA Ultimate, GoLand, PyCharm Professional, PhpStorm, RubyMine, WebStorm, Rider, CLion, and RustRover.

​
Prerequisites

  1. JetBrains Toolbox installed on your system.
Keep JetBrains Toolbox updated for the best experience.

​
Opening an environment

  1. Start an environment in Ona.
  2. Click the dropdown arrow next to the Open button on the action bar and select your preferred JetBrains IDE (e.g., IntelliJ IDEA Ultimate).

​
First-time setup

On first use, JetBrains Toolbox will:
  1. Install the Ona plugin. Click Install when prompted.
  2. Authenticate. A browser window opens to sign in to your Ona account.
  3. Download the IDE backend. Toolbox provisions the IDE backend in your environment.
  4. Launch the IDE client. The local thin client opens and connects automatically.

​
Faster startup with prebuilds

Enable JetBrains warmup in your project’s prebuild configuration to reduce startup time. Warmup pre-installs the IDE backend and builds project indexes during prebuilds, so users skip those steps when opening the editor.

​
Plugin customization

Add plugins to your devcontainer.json using the customizations.jetbrains.plugins property: 
{
	"customizations": {
		"jetbrains": {
			"plugins": [
				"org.intellij.plugins.hcl",
				"com.intellij.kubernetes"
			]
		}
	}
}

​
Finding plugin IDs

  1. Visit the JetBrains Marketplace
  2. Search for your desired plugin
  3. Copy the plugin ID from Additional Information at the bottom of the plugin details page
JetBrains Marketplace plugin page showing Plugin ID in Additional Information section

​
Limitations

  • JetBrains IDE settings (keymaps, themes, inspections) cannot be pre-configured via devcontainer.json. Configure them manually after connecting.
  • Port forwarding configurations from devcontainer.json are not automatically applied. Expose ports manually through the IDE or CLI.

​
Managing authentication

To change your Ona account or sign out:
  1. Open JetBrains Toolbox
  2. Go to Settings → Providers → Ona
  3. Click “Sign Out”
  4. Click “Sign In” to authenticate with a different account

​
Rebuilding Dev Containers

  1. Close your current IDE window
  2. Wait for the rebuild to complete
  3. Return to Ona and select the IDE in the action bar to reconnect

​
Troubleshooting

​
Connection issues

  1. Verify JetBrains Toolbox is running.
  2. Ensure your environment is running in Ona.
  3. Try closing the IDE and reopening from Ona.

​
Collecting logs

Toolbox logs: Open JetBrains Toolbox → Settings → About → “Show log files” → send toolbox.log to support@ona.com. IDE logs: Open JetBrains Toolbox → click the three dots next to the IDE entry → “Show log files” → send to support@ona.com.
Do NOT share logs publicly as they may contain sensitive information.

​
Additional resources