Skip to main content
This guide covers common issues and their solutions for both the Oximy sensor and dashboard.

​
Quick Diagnostics

Before diving into specific issues, verify these basics:
CheckHow to verify
Sensor runningOximy icon visible in menu bar
Certificate installedKeychain Access → search “Oximy CA”
Proxy enabledSystem Preferences → Network → Proxies

​
Enrollment Issues

​
Enrollment code expired

Codes expire after 10 minutes for security.
Solution:
  1. In the dashboard, click Generate new token
  2. Enter the new code within 10 minutes
  3. Make sure your device’s clock is set correctly

​
Device not connecting

Symptoms: Dashboard shows “Waiting for device to connect…” but nothing happens. Check these:
  • Verify the device has internet access
  • Try a different network (corporate proxies may interfere)
  • Check that your firewall isn’t blocking Oximy
  • Codes are 6 digits (e.g., 158 221)
  • Watch for similar-looking characters (0 vs O, 1 vs l)
  • Copy-paste from the dashboard if possible
  • macOS: Check for Oximy icon in menu bar
  • Windows: Check for Oximy icon in system tray
  • Try quitting and reopening the app

​
Device shows offline after enrollment

Cause: The sensor app stopped running. Solution:
  • macOS: Open Oximy from Applications
  • Windows: Open Oximy from Start menu
  • Check if the computer went to sleep

​
Detection Issues

​
No activities appearing

Symptoms: Sensor is running but no activities show in the dashboard.
1

Verify sensor is running

Check for the Oximy icon in your menu bar (macOS) or system tray (Windows).
2

Check permissions

Go to System Preferences → Security & Privacy → Privacy:
  • Accessibility: Oximy should be checked
  • Grant any other permissions if prompted
3

Verify certificate is installed

Open Keychain Access, search for “Oximy CA”. It should appear in your System or login keychain.
4

Check proxy is enabled

Go to System Preferences → Network → Advanced → Proxies. Web Proxy and Secure Web Proxy should point to 127.0.0.1.
5

Test with a supported tool

Try using ChatGPT, Claude, or another major AI tool. The sensor detects 60+ AI services.

​
Activities delayed

Normal: Activities typically appear within a few seconds. If delays exceed 30 seconds:
  • Check your internet connection
  • The sensor syncs periodically; slight delays are normal
  • Try manually syncing from sensor Settings (macOS)

​
Wrong tool showing

Solution: Use the Missing an app? feature in the Inventory page to report detection issues. The Oximy team will investigate.

​
Certificate Issues

​
SSL errors in browsers

Symptoms: “NET::ERR_CERT_AUTHORITY_INVALID” or similar certificate warnings.
Verify trust settings:
  1. Open Keychain Access
  2. Search for “Oximy CA”
  3. Double-click the certificate
  4. Expand Trust section
  5. Set “When using this certificate” to Always Trust
Reinstall if needed:
  1. In Oximy Settings, toggle certificate off
  2. Toggle certificate on again
  3. Enter your password when prompted

​
Certificate installation failed

macOS:
  • Ensure you have admin rights
  • Check disk space in your home directory
  • Try: mkdir -p ~/.oximy && chmod 755 ~/.oximy
Windows:
  • Run Oximy as Administrator
  • Check that antivirus isn’t blocking the operation
  • Verify disk space

​
Proxy Issues

​
Port already in use

Symptoms: “Port 1030 already in use” error. Solution: 
# Find what's using the port
lsof -i :1030

# Kill if it's a stuck process
kill -9 PID
Restart Oximy — it will find the next available port automatically.

​
Some apps not using proxy

Certain applications bypass system proxy settings. For CLI tools, set environment variables: 
export HTTP_PROXY=http://127.0.0.1:1030
export HTTPS_PROXY=http://127.0.0.1:1030

​
Dashboard Issues

​
Can’t sign in

  • Verify your email address is correct
  • Use Forgot password to reset if needed
  • Check for caps lock
  • Check your email for the verification link
  • Check spam/junk folder
  • Request a new verification email
  • Clear browser cache and cookies
  • Try an incognito/private window
  • Try a different browser (Chrome recommended)

​
Dashboard not loading

  • Use a supported browser: Chrome, Firefox, Safari, or Edge
  • Update to the latest browser version
  • Ensure JavaScript is enabled
  • Check for browser extensions blocking scripts
  • Clear browser cache

​
Session expired

Sessions expire after inactivity for security. Refresh the page and sign in again.

​
Settings Issues

​
Timezone not updating

  1. Select your timezone from the dropdown
  2. Click Save changes
  3. Wait for the “Settings saved” confirmation
  4. Refresh the page if times don’t update

​
Keyboard shortcuts not working

Common causes:
  • Focus is in a text input field (click outside)
  • A modal or drawer is open (press Esc to close)
  • Browser extension is intercepting the shortcut

​
Reset & Recovery

​
Soft reset

Quit and relaunch the Oximy sensor app. This reinitializes services without losing data.

​
Clear preferences (keep data)

In Oximy: Settings → Advanced → Reset All SettingsOr via Terminal:
defaults delete com.oximy.mac

​
Complete reset

This deletes all local data and settings.
# Quit Oximy first
rm -rf ~/.oximy/
defaults delete com.oximy.mac
# Open Keychain Access, delete "Oximy CA"

​
Getting Help

If you can’t resolve an issue:
  1. Collect information:
    • Operating system and version
    • Oximy app version (from Settings)
    • Error messages or screenshots
    • Steps to reproduce
  2. Check logs:
    • macOS: ~/.oximy/logs/
    • Windows: %USERPROFILE%\.oximy\logs\
  3. Contact support:

​
Quick Reference

ProblemQuick Fix
Code expiredGenerate new token
Device offlineCheck sensor app is running
No activitiesVerify permissions and certificate
SSL errorsReinstall certificate
Can’t sign inReset password
Dashboard blankClear cache, try different browser
Wrong timesChange timezone in Settings