Start here
Works onWindowsUbuntuUpdated 2026-09-23
In short
Most problems clear up by restarting the virtual machine, reinstalling Any OS Tools, and updating the app, in that order. The VM card's status text and the Check status button point to the cause.
Reading the VM card's status
| Status | Meaning | What to try |
|---|---|---|
Needs attention | Something went wrong and the virtual machine stopped. | Open Logs and restart the virtual machine. |
Shutdown state needs checking | Couldn't confirm whether the virtual machine fully shut down. | Wait a moment and check again. Relaunch the app if it persists. |
Suspended | State was saved to disk and it's off. | Click Resume. |
For a running virtual machine, click Check status to see whether Any OS Tools is responding.
Try these in order
- 1.Restart the virtual machine. Restart from inside the virtual machine, or click
Shut downon the VM card and thenStart.Shut downasks the operating system to power off, so wait for it to finish. - 2.Reinstall Any OS Tools. Click
Any OS Tools…on a running VM card and chooseReinstall Any OS Tools(orUpdate Any OS Tools). Most clipboard, shared folder, resolution, and seamless mode issues clear up here. - 3.Update the app. Check you're on the latest version with
Any OS › Check for Updates…. See Updating the app. - 4.Check the logs. If that doesn't help, follow Collecting logs to gather them.
When Any OS Tools won't install
- On Windows, a permission prompt appears on the virtual machine screen during installation. Click
Yesfor it to install. - If you decline the permission prompt or the install fails, the CD stays inserted. Run
Install.ps1from the CD as administrator inside the virtual machine. The guest tools didn't respond, so only the CD was inserted.. Log in to the virtual machine and install directly from the CD as above.- Ubuntu installs on its own with no prompt. If the graphics driver installs along with it, you'll be told to restart Ubuntu.
When Resume doesn't work
Couldn't restore the saved state. The saved state is left intact. Try again, and check the logs if it keeps failing.- If you see
This was suspended by a different engine version and can't be resumed in this versionafter updating the app, chooseRestartto boot fresh without the saved state. Anything unsaved inside the virtual machine is lost when you do. ChoosingCancelleaves the saved state intact. - If the screen stays black, see Black screen after resume.
Help by symptom
Related Articles
Was this article helpful?
Still stuck?
Search the Help Center by symptom or contact our support team.