Skip to main content

​
Quick Installation

The easiest way to install Koala Data Explorer is directly from the VS Code Marketplace.

​
Method 1: Install from VS Code

  1. Open VS Code
  2. Click the Extensions icon in the Activity Bar (or press Ctrl+Shift+X)
  3. Search for “Koala Data Explorer”
  4. Click Install on the extension by BTSS Corp
  5. Wait for installation to complete
Make sure you select the official extension published by btss-corp

​
Method 2: Install from Marketplace Website

  1. Visit the VS Code Marketplace
  2. Click Install
  3. VS Code will open automatically
  4. Confirm the installation in VS Code

​
Method 3: Command Palette

  1. Open VS Code Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
  2. Type: ext install btss-corp.koala-data-explorer
  3. Press Enter to install

​
Verify Installation

After installation, verify the extension is installed correctly:
  1. Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
  2. Type: “Koala”
  3. You should see “Koala Data Explorer: Open SQL Query Editor”
If you see the command, the extension is installed successfully!

​
Post-Installation Steps

​
1. Open the SQL Query Editor

# Using Command Palette
Ctrl+Shift+P (Windows/Linux)
Cmd+Shift+P (Mac)

# Then type:
Koala Data Explorer: Open SQL Query Editor

​
2. Initial Configuration

The extension works out of the box, but you can customize settings:
  1. Open VS Code Settings (Ctrl+, or Cmd+,)
  2. Search for “Koala”
  3. Configure options like timeout, max rows, and logging

​
3. Set Up Your First Connection

Once installed, you’ll need to:
  1. Open the SQL Query Editor
  2. Click Manage Connections in the top-left
  3. Add your Oracle Fusion connection details
See First Connection Setup for detailed connection instructions

​
Extension Information

​
Publisher Details

  • Publisher: BTSS Corp (btss-corp)
  • Extension ID: btss-corp.koala-data-explorer
  • Version: Check marketplace for latest
  • Size: ~15 MB

​
What Gets Installed

The extension includes:
  • SQL Query Editor with Monaco Editor
  • Data grid components (AG-Grid)
  • Oracle Fusion SOAP client
  • Authentication providers
  • Export utilities

​
Installation Location

The extension is installed in your VS Code extensions folder: Windows: 
%USERPROFILE%\.vscode\extensions\btss-corp.koala-data-explorer-x.x.x
macOS/Linux: 
~/.vscode/extensions/btss-corp.koala-data-explorer-x.x.x

​
Updating the Extension

​
Automatic Updates

VS Code automatically checks for extension updates by default. When an update is available:
  1. You’ll see a notification
  2. Click Update to install
  3. Reload VS Code when prompted

​
Manual Update Check

  1. Open Extensions view (Ctrl+Shift+X)
  2. Click the … menu
  3. Select Check for Extension Updates
  4. Update Koala Data Explorer if available

​
Update Settings

Configure auto-update behavior in VS Code settings: 
{
  "extensions.autoUpdate": true,
  "extensions.autoCheckUpdates": true
}

​
Troubleshooting Installation

​
Extension Not Found

If you can’t find the extension:
  • Ensure VS Code version is 1.74.0 or higher
  • Check your internet connection
  • Try searching for “Oracle Fusion” or “BTSS”

​
Installation Failed

If installation fails:
  1. Check VS Code output panel for errors
  2. Restart VS Code and try again
  3. Clear VS Code cache: 
    # Windows
rmdir /s "%APPDATA%\Code\Cache"

# macOS/Linux
rm -rf ~/.config/Code/Cache

​
Extension Not Loading

If the extension doesn’t appear after installation:
  1. Reload VS Code window (Ctrl+R or Cmd+R)
  2. Check extension is enabled in Extensions view
  3. Look for errors in Help → Toggle Developer Tools

​
Behind Corporate Proxy

Configure proxy settings if behind a firewall: 
{
  "http.proxy": "http://proxy.company.com:8080",
  "http.proxyStrictSSL": false
}

​
Uninstalling

To remove the extension:
  1. Open Extensions view (Ctrl+Shift+X)
  2. Find Koala Data Explorer
  3. Click the gear icon → Uninstall
  4. Reload VS Code
Uninstalling removes the extension but preserves your connections and settings. To completely remove all data, manually delete the extension’s storage folder.

​
License Activation

After installation, the extension runs in Free mode by default. To unlock all features:
  1. Open the SQL Query Editor
  2. Click the Manage License button (key icon)
  3. Choose to start a trial or enter a license key
  4. Follow the activation prompts
See Licensing Guide for detailed license management instructions

​
Next Steps

Now that you have Koala Data Explorer installed:

First Connection

Set up your first Oracle Fusion connection

Configuration

Configure extension settings

Writing Queries

Start querying your data

User Guide

Learn all features