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.
Prerequisites
Before starting, ensure that you have:
- JetBrains Toolbox installed on your system
Keep JetBrains Toolbox for the best experience.
Opening an Environment
- Start an environment in Ona
- Select your preferred JetBrains IDE (e.g., “Open IntelliJ IDEA Ultimate”) from the action bar
First-time Setup
On your first environment open, the setup process will:
- Launch JetBrains Toolbox
- Install the Ona plugin when prompted
- Request authentication with your Ona account
Connection Process
After authentication, Toolbox will:
- Download and provision the IDE backend
- Start your local IDE client
- Connect to your environment automatically
Faster Startup with Prebuilds
Enable JetBrains warmup in your project’s prebuild configuration to significantly reduce editor startup time. When warmup is enabled:
- The JetBrains backend is pre-installed during prebuilds
- Project indexes are built ahead of time
- Users skip the download and indexing steps when opening the editor
This is especially beneficial for large projects where indexing can take several minutes.
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:
- Visit the JetBrains Marketplace
- Search for your desired plugin
- Copy the plugin ID from Additional Information at the bottom of the plugin details page
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:
- Open JetBrains Toolbox
- Go to Settings → Providers → Ona
- Click “Sign Out”
- Click “Sign In” to authenticate with a different account
Managing Environments
Toolbox list shows only recent environments you’ve previously opened. Open new environments from Ona directly.
Rebuilding Dev Containers
When rebuilding a Dev Container:
- Close your current IDE window
- Wait for rebuild to complete
- Return to Ona
- Select the IDE in the action bar to reconnect
Troubleshooting
Connection Issues
If your IDE doesn’t connect:
- Verify JetBrains Toolbox is running
- Ensure your environment is running in Ona
- Try closing the IDE and reopening from Ona
For persistent issues:
- Open JetBrains Toolbox
- Navigate to Settings → About
- Click “Show log files”
- Locate
toolbox.log
- Send to [email protected]
Do NOT share logs publicly as they may contain sensitive information
Collecting IDE Logs
For persistent issues:
- Open JetBrains Toolbox
- Navigate to your environment
- Click on the three dots next to the IDE entry in the installed IDE list
- Click “Show log files”
- Send to [email protected]
Do NOT share logs publicly as they may contain sensitive information
Additional Resources
Network access requirements
