Skip to main content

Installing Noxys on Edge

This guide covers installing the Noxys browser extension on Microsoft Edge.

Prerequisites​

  • Microsoft Edge version 90 or later
  • Administrator access to your Noxys tenant
  • Internet connection

The easiest way to install Noxys on Edge is via the official Microsoft Edge Add-ons store.

Steps​

  1. From the Noxys Dashboard, navigate to Settings → Extension Setup
  2. Click the Microsoft Edge Add-ons link (or Chrome Web Store link, which Microsoft Edge also supports)
  3. You'll be taken to the Noxys extension page
  4. Click Get or Add to Edge
  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 browsing history: Limited to AI platform URLs only
  6. Click Add extension to confirm
  7. The Noxys icon appears in your Edge 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 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., C:\Users\YourName\noxys-extension-dev)
  3. Open Microsoft Edge and navigate to edge://extensions/
  4. Toggle Developer mode (bottom left)
  5. Click Load unpacked
  6. Navigate to 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 edge://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 "Edge 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.

Enterprise Deployment​

Group Policy (Windows Domain)​

If you're managing Edge across your organization via Group Policy:

  1. Deploy the Noxys extension using Microsoft Edge Recommended Extensions policy:
    • Open Group Policy Editor: gpedit.msc
    • Navigate to Computer Configuration → Administrative Templates → Microsoft Edge
    • Find Control which extensions are installed silently
    • Add the Noxys extension ID
  2. The extension will automatically install on all managed Edge instances
  3. Configure API tokens via Microsoft Intune

Configuration via Microsoft Intune​

For organizations using Intune, you can deploy Noxys and pre-configure API tokens. See Enterprise Deployment via Microsoft Intune for detailed steps.

Troubleshooting​

Extension Won't Install​

Problem: Edge shows an error like "This extension is not available" or "Installation failed."

Solution:

  • Clear your Edge cache: Settings → Privacy → Clear browsing data → Extensions
  • Restart Edge
  • Try installing again
  • If using a managed Edge 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 Edge

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 edge://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 edge://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 edge://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 edge://extensions/
    • Search for "Noxys"
    • Ensure the toggle is turned on
  • Restart Edge if you just installed it

Clipboard Permission Warning​

Problem: Edge 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, Noxys can run 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?​