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 authentication session may have expired. Sign out via the sidebar footer or Profile, then sign back in. Sync will restart automatically.
  • Network or corporate firewall: Computtite requires outbound HTTPS access (*.supabase.co) to sync. On managed networks, ask your network administrator to allow outbound connections to the Supabase endpoint.
  • Changes stuck in “failed” state: If a specific mutation repeatedly fails after the exponential backoff retries, inspect the error message by clicking the sync status indicator in the sidebar footer.

Asset Not Appearing in Lists or Reports

  • Wrong asset type selected: The asset grid filters by category. Verify that the asset type selector in the header matches the category under which the asset was registered.
  • Active search or column filter: An active query or column filter may be hiding records. Clear filters via the reset button in the table header.
  • Visibility restriction: In Cloud Mode, assets configured with “Admins only” are hidden from Members and Viewers. Assets configured with “Restricted” visibility are accessible only to members assigned to an authorized permission profile.
  • Sync cycle pending: In Cloud Mode, newly registered assets from another machine or Mobile Companion propagate on the next 10-second sync cycle.

Fields Not Showing Expected Values

  • Derived field showing incorrect value: Derived fields (days_until, years_since, days_since) compute dynamically relative to the current calendar date. If the source date is empty or invalid, the derived value returns blank. Verify the source date field on the asset.
  • Number field unformatted: Display format masks (currency, memory_gb, percentage) format visually at render time. Ensure the display format is enabled for that field in Tipos de activo (/workspace/activos).
  • 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.