Ona seamlessly integrates with JetBrains IDEs including IntelliJ IDEA Ultimate, GoLand, PhpStorm, PyCharm, RubyMine, WebStorm, Rider, CLion, and RustRover. This guide will walk you through the setup process and provide tips for managing your development environments.

Ona Website in WebStorm

​
Prerequisites

Before starting, ensure that you have:
  1. JetBrains Toolbox installed on your system
Tip: Keep JetBrains Toolbox for the best experience.

​
Opening an Environment

  1. Start an environment in Ona
  2. Select your preferred JetBrains IDE (e.g., “Open IntelliJ IDEA Ultimate”) from the action bar

Open from Environment Details

​
First-time Setup

On your first environment open, the setup process will:
  1. Launch JetBrains Toolbox
  2. Install the Ona plugin when prompted

Plugin Installation

  1. Request authentication with your Ona account

Authentication

​
Connection Process

After authentication, Toolbox will:
  1. Download and provision the IDE backend

Installing JetBrains IDE Backend

  1. Start your local IDE client

Installing JetBrains IDE Client

  1. Connect to your environment automatically

Connection Progress

​
Plugin Customization

You can customize JetBrains IDE plugins using your devcontainer.json configuration. This allows you to pre-install plugins for your team and ensure consistent development environments.

​
Basic Plugin Configuration

Add plugins to your devcontainer.json by adding the Plugin ID list to the customizations.jetbrains.plugins property: 
{
	"customizations": {
		"jetbrains": {
			"plugins": [
				"org.intellij.plugins.hcl",
				"com.intellij.kubernetes"
			]
		}
	}
}

​
Finding Plugin IDs

To find the correct plugin ID:
  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

Location of Plugin ID on JetBrains Marketplace

​
Limitations

  • The version of JetBrains IDEs cannot be changed.
  • JetBrains IDE settings cannot be customized.

​
Managing Authentication

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

Signing Out

​
Managing Environments

Toolbox list shows only recent environments you’ve previously opened. Open new environments from Ona directly.

Recent Environments

​
Rebuilding Dev Containers

When rebuilding a devcontainer:
  1. Close your current IDE window
  2. Wait for rebuild to complete
  3. Return to Ona
  4. Select the IDE in the action bar to reconnect

​
Troubleshooting

​
Connection Issues

If your IDE doesn’t connect:
  1. Verify JetBrains Toolbox is running
  2. Ensure your environment is running in Ona
  3. Try closing the IDE and reopening from Ona

​
Collecting Toolbox Logs

For persistent issues:
  1. Open JetBrains Toolbox
  2. Navigate to Settings → About
  3. Click “Show log files”
  4. Locate toolbox.log
  5. Send to support@ona.com

Collecting Toolbox Logs

Do NOT share logs publicly as they may contain sensitive information

​
Collecting IDE Logs

For persistent issues:
  1. Open JetBrains Toolbox
  2. Navigate to your environment
  3. Click on the three dots next to the IDE entry in the installed IDE list
  4. Click “Show log files”
  5. Send to support@ona.com

Collecting IDE Logs

Do NOT share logs publicly as they may contain sensitive information