Skip to content

Common Issues

This page covers the most frequent problems users encounter and how to resolve them. If your issue is not listed here, check the Diagnostics page or open a GitHub issue.

Google or Notion OAuth Connection Fails

If clicking "Connect" opens the browser but the connection never completes or shows an error:

  • Browser did not open: Your system's default browser may be misconfigured. Try setting a default browser in your OS settings, then retry.
  • Connection not completing: A security tool or firewall may be interfering with the connection callback. Check your internet connection and retry. If the issue persists, temporarily disable security software and retry.
  • Error after approving in browser: Close the browser tab, restart the connection from Settings → Integrations, and complete it in one go without navigating away mid-flow.
  • Notion shows an error page: The Notion connection depends on internet connectivity during the redirect. Check your connection and retry.

In all cases, the fastest fix is to go to Settings → Integrations, disconnect the failing integration, and run the setup flow again from scratch.

Sync Shows Persistent "Error" State

Common causes and fixes:

  • Expired session: Your login session may have expired. Go to Settings → Account, sign out, then sign back in. Sync will restart automatically.
  • Network or corporate firewall: Computtite needs outbound HTTPS access to sync. If you're on a managed corporate network, ask your IT team to allow the sync endpoint.
  • Changes stuck in "failed" state: If specific changes repeatedly fail to sync, contact support with the error details from Settings → Sync → View sync log.

Asset Not Appearing in Lists or Reports

  • Wrong asset type selected: The asset list is filtered by type. Make sure the type selector at the top of the Assets view matches the type you registered the asset under.
  • Search or filter active: An active search query or filter may be hiding the asset. Clear all filters using the reset button in the filter panel.
  • Visibility restriction: If you are not an Admin or Owner, assets set to "Admins only" visibility will not appear in your lists. Ask an Admin to check if the asset has a visibility restriction.
  • Sync not complete: In cloud mode, if you just registered the asset on another device, wait for the next sync cycle (up to 10 seconds) before it appears on your device.

Fields Not Showing Expected Values

  • Derived field showing incorrect value: Derived fields (days_until, years_since, etc.) are computed from the source date field using today's date. If the source date is empty or invalid, the derived field will show blank or zero. Check that the source date field has a valid date entered.
  • Number field showing raw number instead of formatted: Display formats (currency, storage_gb, etc.) are applied in the UI only. If a field appears to show the raw number, check the field's display format setting in Forge (Settings → Forge → edit the asset type).
  • Select field showing blank: If a select field's options were modified after assets were registered, existing values that no longer match any option will appear blank. Edit the asset to reassign the field to a current option, or restore the old option in Forge.

App Won't Start / Shows Blank Screen

  • On macOS: Make sure you dragged the app to the Applications folder. Running it directly from the .dmg disk image can cause permission issues.
  • On Windows: If you see a "DLL not found" or similar error, try reinstalling via the .exe installer. If SmartScreen blocked the first run, allow it through System Settings → Privacy → Security.
  • On Linux: Confirm the AppImage is marked as executable (chmod +x). Some minimal Linux setups may need an additional system package — check the Downloads page for the recommended dependencies for your distribution.
  • Recovery screen on startup: If the app immediately shows a data recovery screen, it detected a problem with your workspace file. Use Settings → Storage → Import database to restore a clean backup.