Skip to main content

Installing Noxys on Chrome

This guide covers installing the Noxys browser extension on Google Chrome or Chromium-based browsers (Edge, Brave).

Prerequisites​

  • Google Chrome version 90 or later (or Edge/Brave equivalent)
  • Administrator access to your Noxys tenant
  • Internet connection

The easiest way to install Noxys is via the official Chrome Web Store.

Steps​

  1. From the Noxys Dashboard, navigate to Settings → Extension Setup
  2. Click the Chrome Web Store link
  3. You'll be taken to the Noxys extension page
  4. Click Add to Chrome
  5. A permissions dialog appears. Review the requested permissions:
    • Access your data on all websites: Required to monitor AI platform usage
    • Modify data you copy and paste: Used to detect PII before submission
    • Read your browser history: Limited to AI platform URLs only
  6. Click Add extension to confirm
  7. The Noxys icon appears in your browser toolbar (top right)

Verify Installation​

  1. Click the Noxys icon in your toolbar
  2. You should see a login or authentication popup
  3. If you see a "Configuration Required" message, proceed to Configure the Extension

Manual Installation (Development or Self-Hosted)​

If you're using a self-hosted instance or a development build, you can manually load the extension.

Steps​

  1. Download the extension ZIP file from your Noxys instance:
    • Navigate to Settings → Extension Setup
    • Click Download Extension Package under "Manual Installation"
  2. Extract the ZIP file to a local folder (e.g., ~/noxys-extension-dev)
  3. Open Chrome and navigate to chrome://extensions/
  4. Toggle Developer mode (top right)
  5. Click Load unpacked
  6. Select the extracted folder and click Select Folder
  7. The extension appears in your extensions list with a Developer Mode label
  8. The Noxys icon appears in your toolbar

Enable or Disable the Extension​

  • Enable: Click the toggle next to the extension in chrome://extensions/
  • Disable: Click the toggle again to disable (useful for troubleshooting)
  • Remove: Click the trash icon to uninstall

Configure the Extension​

Once installed, configure the extension to authenticate with your Noxys backend.

  1. Click the Noxys icon in your toolbar
  2. A popup window opens
  3. If it's your first time, click Configure
  4. You'll be prompted for your API token:
    • Go back to the Noxys Dashboard → Settings → API Keys
    • Copy your default API token (or create a new one labeled "Chrome Desktop")
    • Return to the extension popup and paste the token
  5. Click Save
  6. The extension validates the token and connects to your backend

Connection Status​

The extension icon indicates connection status:

Icon ColorStatusWhat to Do
GreenConnectedMonitoring is active. All systems normal.
RedConnection ErrorCheck API token, backend URL, or network connectivity.
GrayOffline ModeExtension is running locally but can't reach the backend. Local policies still enforced.
YellowInitializingExtension is starting up. Wait a few seconds.

Troubleshooting​

Extension Won't Install​

Problem: Chrome shows an error like "This extension is not available in your location" or "Installation failed."

Solution:

  • Clear your Chrome cache: Settings → Privacy → Clear browsing data → Extensions
  • Restart Chrome
  • Try installing again
  • If using a managed Chrome instance, your administrator may have extension install policies. Contact your IT team.

Extension Shows Red Icon (Connection Error)​

Problem: Extension can't reach the Noxys backend.

Solution:

  • Verify your API token is correct:
    • Go to Settings → API Keys
    • Generate a new token if needed
    • Copy the exact token (no spaces or extra characters)
  • Check your backend URL:
    • For noxys.cloud users, this should auto-detect
    • For self-hosted, go to Settings → Advanced and verify the backend URL
  • Verify network connectivity:
    • Check that api.noxys.cloud (or your backend domain) is accessible
    • If behind a corporate proxy, ensure the proxy doesn't block the extension
  • Try logging out and back into the Noxys Dashboard to refresh your token
  • Restart Chrome

Extension Not Detecting AI Usage​

Problem: Dashboard shows no activity even though you're visiting ChatGPT, Claude, etc.

Solution:

  • Confirm the extension is installed and enabled:
    • Check your toolbar for the Noxys icon
    • Go to chrome://extensions/ and verify the toggle is on
  • Refresh the AI platform page after the extension is installed
  • Check the extension has proper permissions:
    • Go to chrome://extensions/ → Click on Noxys → Permissions
    • Ensure "Access your data on all websites" is checked
  • Open your browser console (F12) and check for errors:
    • Go to the Console tab
    • Visit an AI platform (e.g., ChatGPT)
    • Look for any red error messages
    • Share errors with support@noxys.eu
  • Disable and re-enable the extension:
    • Go to chrome://extensions/
    • Toggle the extension off, wait 5 seconds, toggle on
    • Refresh the AI platform page

Can't Find the Noxys Icon​

Problem: You installed the extension but don't see the icon in your toolbar.

Solution:

  • The icon might be hidden behind the extension menu:
    • Look for a puzzle icon in the top right
    • Click it to see installed extensions
    • Pin the Noxys icon by clicking the pin icon next to its name
  • Verify the extension is enabled:
    • Go to chrome://extensions/
    • Search for "Noxys"
    • Ensure the toggle is turned on
  • Restart Chrome if you just installed it

"Modify Data You Copy and Paste" Permission Warning​

Problem: Chrome shows a warning about clipboard access.

Solution:

  • This permission is necessary for Noxys to detect PII before you paste it into an AI platform
  • If you're uncomfortable granting this permission, Noxys will still monitor submitted content, but won't catch pasted data in advance
  • You can disable clipboard monitoring in Settings → Extension → Advanced if needed

Advanced Configuration​

Offline Mode​

If your organization's network restricts backend connectivity, you can run Noxys in Offline Mode:

  1. Install the extension normally
  2. If the extension detects no backend connectivity, it automatically switches to Offline Mode
  3. Local policies are enforced without cloud synchronization
  4. When connectivity is restored, the extension syncs with the backend

Policy Sync​

Policies are automatically downloaded and cached locally on your device:

  1. When you create or update a policy in the Noxys Dashboard, it syncs to installed extensions within 30 seconds
  2. You don't need to manually refresh or reinstall the extension
  3. To force a manual sync, click the Noxys icon → Settings → Sync Policies Now

Next Steps​

Need Help?​