Skip to content
English
  • There are no suggestions because the search field is empty.

Troubleshooting Time Doctor Installation and First-Time Setup

Note: This troubleshooting guide applies to both the Interactive Desktop App and the Automatic App. Availability depends on the selected app type, company tracking mode, operating system, and environment.

TL;DR:
If Time Doctor installation does not feel smooth, first confirm the correct app type, operating system, desktop environment, and provisioning path. Most setup issues happen because the wrong app was chosen for the environment, the company tracking mode does not match the expected installer, macOS permissions were not granted, Ubuntu is using Wayland, SSO users were not provisioned correctly, or the Automatic App was deployed across multiple profiles or environments.

 

Use this guide when installation, sign-in, or first-time setup is not working as expected.

Start with the environment check before moving to operating system-specific fixes.

 

Step 1: Confirm the expected app type

Ask the following:

  • Should tracking be user-controlled or silent?
  • Is the device mixed-use or work-only?
  • Is the user in the European Union?
  • Is the device local, managed, virtual, or remote-hosted?

If the wrong app type was chosen, restart with the correct installation path.

 

Step 2: Check the most common root causes

The expected installer is missing from the Downloads page

Possible causes:

  • the company tracking mode does not allow that app type

  • the user does not have the access needed to retrieve the installer

  • the company is in the EU and the Automatic App is not available

 

The user cannot sign in after installation

Possible causes:

  • the user was not invited

  • the user was not added by CSV

  • the SSO setup does not allow self-join

  • no allowed domains were configured for SSO discovery

 

The app installs but setup still feels incomplete on macOS

Possible cause:

  • required permissions and notifications were not granted after installation

 

The Interactive app does not work properly on Ubuntu

Possible cause:

  • the computer uses Wayland instead of Xorg (X11)

Use the Time Doctor Browser App instead.

 

Tracking does not behave as expected in a VM or remote session

Possible cause:

  • the app is installed inside the VM, so only VM activity is tracked

  • local computer activity is not tracked from inside the remote session

 

Duplicate Automatic App users appear

Possible causes:

  • the same person signed in on both local and virtual devices

  • the app was installed across multiple OS profiles

  • the OS was reinstalled

  • the deployment scope was too broad

 

Step 3: Apply the fix by scenario

Wrong deployment method

Reinstall using the environment-appropriate path:

  • Group Policy for domain-managed Windows rollout

  • Intune for managed deployment

  • Jamf for managed macOS deployment

  • JumpCloud for Windows or macOS managed command rollout

  • direct install from Downloads for single-user Interactive setup

 

Provisioning problem

Use the correct user onboarding method:

  • invite the user

  • add Interactive users by CSV

  • configure SSO discovery or provisioning properly

 

macOS permissions problem

Open the relevant macOS settings and grant the required permissions for the installed Time Doctor app version.

 

Ubuntu compatibility problem

If the device uses Wayland, stop troubleshooting the Interactive desktop install and switch to the Browser Apppath.

 

Duplicate profile problem

Reduce future duplicates by keeping one managed device per person and limiting installs to required devices or sessions only.

Delete unused duplicate profiles or request a merge if historical data from both must be retained.

 

 

Step 4: Verify the result

After applying the fix, confirm:

  • the correct app is installed
  • the user can sign in
  • tracking starts as expected
  • required permissions are granted
  • no duplicate users are being created unintentionally

 

Related articles

 

 

 

 

Should there be any inconsistencies or concerns regarding the article, contact support@timedoctor.com for prompt assistance.