User Documentation · Chapter 4

First Launch and Verification

Signing in, checking the installation is healthy, microphone access, updates and uninstalling.

With Mockingjay installed, the next step is to open it, sign in, and confirm that it is working correctly. This chapter also explains how to allow microphone access for voice input, how to keep Mockingjay up to date, and how to remove it if you ever need to.

#Signing in for the first time

Open Mockingjay from your Start menu, Applications folder or application launcher. The window title bar reads Mockingjay, and after a few seconds you are asked to sign in. Enter the email address and password for your Mockingjay account. If you do not have an account yet, follow the prompts to create one.

The first launch can take a little longer than usual while the application prepares itself. Once you are signed in, Mockingjay opens your Default project and shows the Welcome Screen, where you can talk to Mockingbird. Your name and your current plan, such as FREE, appear in the account panel at the bottom of the left-hand sidebar.

#Checking that the installation is healthy

Before you start building agents, it is worth spending a minute confirming that everything is connected. Mockingjay shows its health through a few simple indicators, and once you know where they are you will be able to spot problems at a glance.

Start with the footer along the bottom of the window. In the bottom-right corner you will see the version number, for example v2.1.73. Make a note of it, because support will ask for it if you ever need help. Nearby is the node indicator, labelled This device. A green dot beside it means that your computer is connected and ready to host agents. The two numbers next to it, which read 0 / 0 on a new installation, count the agents running on the node and its available capacity; they stay at zero until you start agents.

Next, look at the header at the top of the main area. It shows the name Mockingbird with a coloured dot. Green means that the orchestrator is ready to receive your requests.

Finally, confirm that your name and plan are shown in the account panel at the bottom left. This tells you that you are signed in to the correct account.

When all of these look right, send Mockingbird a simple test message, such as “What capabilities do you have?”, and wait for a reply. If Mockingbird responds, your installation is complete and working. If any indicator is orange or red, or Mockingbird does not reply, see the Troubleshooting chapters.

#Allowing microphone access

Mockingjay lets you dictate requests by voice instead of typing them. To use this feature, your operating system must allow Mockingjay to use the microphone.

On Windows, open Settings, go to Privacy & security, then Microphone, and make sure that microphone access is turned on and that desktop applications are allowed to use it. On macOS, open System Settings, go to Privacy & Security, then Microphone, and turn on the switch next to Mockingjay. On Linux, check your desktop’s sound and privacy settings, and confirm that the correct input device is selected in PulseAudio or PipeWire; a tool such as pavucontrol makes this easy. If you installed Mockingjay as a sandboxed package, it may need additional permissions to reach the microphone.

After changing a permission, restart Mockingjay so that it picks up the new setting.

#Keeping Mockingjay up to date

New versions of Mockingjay add features and fix problems, so it is a good idea to stay current. You can check which version you are running by looking at the footer. When a new version is released, the application may show an update prompt; if it does, simply accept it. Otherwise, download the new installer and install it using the same steps you followed the first time.

On Linux, a .deb or .rpm package can be upgraded by installing the newer package over the existing one. If you use the AppImage, replace the old file with the new one. Your projects and agents are normally kept when you update, but we recommend backing up any important data before you upgrade, just in case.

#Uninstalling Mockingjay

If other people use the same computer, sign out of Mockingjay before removing it. Then uninstall it in the usual way for your operating system.

On Windows, open Settings, go to Apps and then Installed apps, find Mockingjay in the list, click the ⋯ button beside it, and choose Uninstall. On macOS, quit Mockingjay, open the Applications folder, and drag Mockingjay to the Bin.

On Linux, remove a .deb installation with sudo apt remove mockingjay, and an .rpm installation with sudo dnf remove mockingjay or, on openSUSE, sudo zypper remove mockingjay. If you used the AppImage, simply delete the .AppImage file and any menu shortcut you created for it.

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