Skip to Content
Unrest LauncherTroubleshooting

Troubleshooting the launcher

Find the message you see in the tables below. A product’s error appears under its button, and the button changes to Retry install, Retry update or Retry launch. A launcher update error appears under the update button in the top bar.

The launcher does not open

What you seeCauseWhat to do
macOS says the app is damaged or cannot be openedThe ZIP may be older than the signed and notarized 0.1.4 release , or the download may be incomplete.Download the current ZIP from the official download page, verify its checksum, and try the fresh copy in Applications. If macOS still blocks it, report the exact message without overriding the warning.
Windows SmartScreen blocks the installerThe beta is not signed for Windows yet.Choose More info, then Run anyway.

Only do this for a file you downloaded from the download page or the releases page . You can check it against SHA256SUMS first: see Check the download.

The library does not load

MessageCauseWhat to do
Could not check installed products. followed by a reasonThe launcher could not read the product states. All product buttons are disabled meanwhile.Choose Retry product check.
Browser preview only. Use the Unrest desktop app to install, launch, and update products.You are looking at a preview in a web browser, not the desktop app.Open the installed Unrest app.

A product is Unavailable

MessageCauseWhat to do
No signed beta release is available for followed by your system, for example macos aarch64This launcher was built without a release of that product for your operating system and processor.Nothing to fix. In the open beta the launcher installs GameGen, on macOS with Apple silicon and on Windows x64.
No release information is available for this product.The launcher returned no state for the product.Update the launcher. See Updates.
Product releases are not configured with a trusted signing keyThis build of the launcher has no product key, so it installs nothing. This is the case for unsigned test builds.Install a released launcher from the download page.

The launcher refuses to install GameGen

The product list built into your launcher must match the published archive byte for byte. When it does not, the launcher refuses and installs nothing.

MessageCauseWhat to do
Product checksum or size verification failedThe download’s size or SHA-256 hash differs from the product list. The download was cut short or changed, or the published file is not the one this launcher expects.Choose Retry install. If it fails again, update the launcher and try once more.
Product download exceeds its declared sizeThe server sent more data than the product list allows.As above.
Invalid product signature or Unsupported product signatureThe archive’s signature is missing, damaged or of the wrong kind.Update the launcher. Do not install the archive by another route.
Product release server refused the downloadThe releases page did not serve the file. The release may not be published, or the network blocked it.Check your connection and that the release is public, then Retry install.
Product requires a newer launcher or has an invalid versionThe release needs a newer launcher than the one you run.Update the launcher.
This product already has an operation in progressAn installation or start of this product is already running, perhaps in a second launcher window.Wait for it to finish.
Expanded product exceeds its file or size limit, Product archive has too many filesThe archive is over the launcher’s limits.Report it. This is a fault in the release.
Could not create product staging directory, Could not retain the completed installation; old versions were not changedThe launcher could not write to its data folder: the disk is full or the folder is not writable.Free disk space, then Retry install. Earlier versions are untouched.

A file on a published release is never replaced. If a release is wrong, a fixed one is published under a higher version, and you get it through a launcher update.

A product does not start

MessageCauseWhat to do
Install this product before launching itNothing is installed for the product.Choose Install.
Could not launch the installed productThe operating system refused to start it.Try Retry launch. On macOS, check whether Gatekeeper blocked the app.
The product exited with an error; its installation is retained because descendant lifetime is unverifiedThe product stopped with an error. The launcher keeps the installation as it is.Start it again. If it keeps failing, see the GameGen docs.
A prior product launch has not been verified as stopped. Managed launch and update are blocked until operator recovery; no app was stopped.The launcher started the product earlier and cannot tell whether every part of it has stopped. It blocks a second start and an update rather than guess.Quit the product completely. The launcher does not clear this block by itself and stops no app. If the message stays, report it.
Managed installation metadata is invalid; recovery is required, Missing active installation pointer; recovery is requiredThe installation records in the launcher’s data folder are damaged or missing.Choose Install or Retry install. The launcher restores the newest complete version it can prove. Do not edit the products-v1 folder by hand.

GameGen on Windows

These messages come from GameGen, not from the launcher.

What you seeCauseWhat to do
Git for Windows is required to run agents. Install it from https://git-scm.com/download/win , restart the app, then press Start again.GameGen did not find Git for Windows. The agents run their commands through its shell.Install Git for Windows, restart GameGen, then choose Start GameGen.
A project shows online, but Stop and Restart answer This application does not own the project’s daemonGameGen stopped unexpectedly earlier and left the project running.Open Task Manager, end agentloop-daemon.exe, then start GameGen again.

See the GameGen requirements.

Launcher updates

MessageCauseWhat to do
Updates unavailableThis build has no update key and never checks.Install a released launcher.
Launcher update status is unavailable.The launcher could not read its own update state.Wait a moment; it reads the state again by itself.
Could not check for a signed launcher update. Try again later.The channel file could not be read, or it did not pass its checks.Check your connection, then choose Check for launcher updates.
Update metadata has an unsupported location or signed version.The channel named a file outside the releases repository, or the signature’s version does not match. The update is refused.Try again later. If it persists, report it.
Check for updates before installing.No checked update is waiting.Choose Check for launcher updates first.
Update installation failed. No unsigned update was accepted; check again to retry.The download, the signature check or the replacement of the app failed. On macOS this includes an app in a read-only location.Move Unrest to a folder you can write to, then check again.

Known limits of the beta

These are known gaps, not faults on your computer:

  • The Windows installer is not signed for Windows yet, so SmartScreen warns on first open. macOS warns for a release that is not signed and notarized by Apple.
  • A new GameGen version needs a new launcher version.
  • The launcher does not uninstall products or remove old versions.
  • The launcher does not sit in the tray or start at login.
  • GameGen reports AgentLoop’s version number, not one of its own.
  • On Windows, an agent run, the Unreal view with an engine installed, Windows 10 and a PC with more than one user account have not been verified yet. See the GameGen requirements.

Next steps

Last updated on