User Documentation · Chapter 7

Installation Issues

Blocked installers, blank windows, sign-in problems and indicators that are not green.

Problems during installation and first launch are usually caused by your operating system’s security checks, by antivirus software, or by network restrictions such as a company firewall. This chapter describes the most common problems and how to resolve them. Work through the suggestions in the order given, checking after each one whether the problem has been solved.

#The installer will not run or is blocked

On Windows, the installer may need administrator rights. Right-click the installer file and choose Run as administrator. If Windows SmartScreen shows a warning that the app is unrecognised, look at the publisher’s name before continuing, and proceed only if it is Mockingjay Network.

On macOS, the system may refuse to open the application because it cannot verify the developer. Open System Settings, go to Privacy & Security, scroll down to the security section, and click Open Anyway next to the message about Mockingjay. Do this only if you downloaded the installer from the official source.

On Linux, an AppImage will not start unless it has been marked as executable. Run chmod +x Mockingjay-*.AppImage in the folder that contains it, then try again. If you see an error that mentions FUSE, install the FUSE 2 library, for example with sudo apt install libfuse2 on Ubuntu 22.04 and later.

On any platform, antivirus or endpoint-protection software may have quarantined the installer. Check your security software’s quarantine list, and if the installer is there, ask your IT department to allow it. If none of these steps helps, the downloaded file may be incomplete or corrupted. Delete it, download a fresh copy from the official source, and try again.

#The application opens to a blank or white window

The first time Mockingjay starts, it may take a little while to prepare itself, during which the window can appear blank. Wait for about 30 seconds before doing anything else.

If the window remains blank, quit the application completely and open it again. Closing the window is not always enough, because the application may continue running in the background; on Windows, check the system tray for its icon, and on macOS, check the menu bar or use Quit from the Dock. If the problem continues, restart your computer, which clears most temporary conditions. As a last resort, reinstall the latest version of Mockingjay.

#You cannot sign in

First, confirm that your computer is connected to the internet, since signing in requires a connection to Mockingjay’s servers. Next, check that you are entering the correct email address and password.

Passwords are case-sensitive, so make sure Caps Lock is off. If you have forgotten your password, use the password reset option if it is offered.

If you are connected to a company network, a proxy server, firewall or VPN may be blocking Mockingjay. Try signing in with the VPN switched off, or from a different network, to see whether that makes a difference. If it does, ask your IT department to allow the Mockingjay application to connect to the internet.

#The node or Mockingbird indicator is not green after installation

If the This device indicator in the footer, or the Mockingbird indicator in the header, shows an orange or red dot after you have signed in, hover the pointer over the dot to see what it reports. Then open ☰ → Nodes and check that This device is listed and enabled; if it is disabled, enable it. Check your internet connection and any firewall or proxy restrictions, as described above. If the indicator is still not green, restart Mockingjay.

Guide version 2.1.73 · October 2026. Still stuck? Write to service@soika.ai or use the contact form.