Installation issues

Fix problems with the download page, the first launch on macOS or Windows, and signing in to Neoo Desktop.

This page covers the most common problems between the download page and your first signed-in session. For the normal steps, see Install Neoo and sign in.

The download button doesn't download

The main button on the download page changes its label to tell you what is missing.

Button labelWhat it meansWhat to do
Checking access…The page is checking your account.Wait a moment.
Sign in to downloadYou are not signed in on the website.Click the button, sign in, then go back to the download page.
Account approval requiredYour account hasn't been approved yet, or its access was removed.Wait for approval. See Your account.
Build temporarily unavailableThe page couldn't load the latest version.Reload the page in a few minutes.
Try the download againThe last download failed.Click it to start again.

macOS says the app can't be opened

Neoo is not yet signed with an Apple Developer ID, so macOS may block the first launch.

  1. Try to open Neoo IDE once, then close the warning.
  2. Open System Settings → Privacy & Security.
  3. Scroll down and click Open Anyway next to the message about Neoo IDE.
  4. Confirm. You only need to do this once.

Make sure you dragged Neoo IDE into Applications before you open it.

Commands can't reach devices on your local network (macOS)

Symptom: a terminal command, an agent or a dev server launched from Neoo works with internet addresses but fails with local addresses such as 192.168.x.x or name.local: EHOSTUNREACH, no route to host, or a timeout.

Cause: macOS Local Network privacy. Everything Neoo launches (terminals, agents, vato run) is covered by Neoo's own permission.

Fix:

  1. Update Neoo IDE to 1.0.135 or later. Earlier versions couldn't ask for this permission on macOS 15 and later, so access was refused without any prompt.
  2. Run the command again. When macOS asks whether Neoo IDE may find devices on your local network, click Allow.
  3. If you clicked Don't Allow, open System Settings → Privacy & Security → Local Network, turn on Neoo IDE, then restart the command.

Windows SmartScreen blocks the installer

The installer is not yet signed with a Windows certificate, so SmartScreen may show a warning.

  1. In the SmartScreen window, click More info.
  2. Click Run anyway.
  3. Follow the installer, then open Neoo IDE from the Start menu.

Sign-in doesn't finish

When you click Sign in in Neoo Desktop, your browser opens the Neoo sign-in page and the app shows Waiting for login….

  • The browser didn't open. Click Cancel sign-in, then Sign in again.
  • You signed in with the wrong account. On the page Continue to Neoo IDE?, click Use a different account.
  • You see "Sign-in timed out. Try again." You have five minutes to finish in the browser. Click Sign in to start again.
  • You see "Unable to initialise sign-in." Neoo couldn't reach its server. Check your internet connection and try again.

After signing in in the browser, come back to Neoo. The app picks up your session on its own.

"Approval required"

Your account exists but isn't approved yet, or its access was denied or suspended. The message under Approval required tells you which. Once your account is approved, click Try again.

"Reconnecting…"

Neoo Desktop shows Reconnecting… when it has a saved session but can't reach the Neoo server, for example during an update or when your Wi-Fi is still reconnecting.

  • Your session is kept. Neoo retries on its own and shows Retrying automatically….
  • Click Try again to retry now.
  • Click Sign in with another account only if you want to sign in again.

If you see Account check unavailable, Neoo is signed in but couldn't check your account. Your session stays active: click Try again in a moment.

Still stuck?

Email support@vatoide.com with your system, the Neoo version and a screenshot of the message.