Mockingjay Network

User Documentation · Chapter 2

Mockingjay Installation – Prerequisites

System requirements, what to prepare, and how to choose the right installer.

Before you install Mockingjay Network, take a few minutes to confirm that your computer is ready and that you have everything you need to hand. Mockingjay is a desktop application that runs on Windows, macOS and Linux. Once installed, the interface and the way you work are identical on all three, so the rest of this guide applies to whichever operating system you use.

System requirements

Mockingjay does more than display a chat window. Your computer acts as a node, which means it can host and run AI agents locally. For that reason, the application needs more memory and storage than a typical desktop program. The table below lists the recommended configuration for each platform.

ComponentWindowsmacOSLinux
Operating systemWindows 10 or 11 (64-bit)A recent macOS release on Apple siliconA recent 64-bit distribution, such as Ubuntu 22.04+, Debian 12+ or Fedora 38+
Processor64-bit multi-core CPUApple M-series64-bit multi-core CPU (x86_64, or ARM where a build is provided)
Memory (RAM)16 GB minimum, 24 GB or more recommended16 GB minimum, 24 GB or more recommended16 GB minimum, 24 GB or more recommended
Free storage256 GB recommended256 GB recommended256 GB recommended
Display1280 × 800 or higher1280 × 800 or higher1280 × 800 or higher, with a desktop environment such as GNOME or KDE
NetworkStable internet connectionStable internet connectionStable internet connection
PermissionsRights to install applicationsAn administrator passwordsudo rights to install system packages

The minimum memory figure is enough to install Mockingjay and work with a small number of agents. If you intend to host several agents or whole fleets on your own computer, we strongly recommend meeting the recommended figures, because each running agent uses memory and storage on the node that hosts it. A stable internet connection is required at all times, as Mockingjay uses it to sign you in, to reach AI models, and to connect your agents to the Global Agentic Neural Network.

Preparing to install

There are a few things to take care of before you begin. Doing them now will save you from interruptions later in the process.

First, download the installer for your operating system from the official Mockingjay Network source only. Installers obtained from other websites may be outdated or may have been tampered with, and your operating system may warn you about them. Later in the installation you will be asked to confirm that the publisher is Mockingjay Network, so it is worth being certain of where your file came from.

Next, make sure you know the email address and password for your Mockingjay account. If you do not yet have an account, you will be able to create one the first time you open the application.

If you are installing Mockingjay on a company computer, check whether your organisation uses a firewall or a proxy server to control internet access. If it does, ask your IT department to allow the Mockingjay application to connect to the internet before you install. Without this, the application may install correctly but be unable to sign you in or reach its AI services.

Finally, if you have an older version of Mockingjay installed, close it completely before installing the new version. If you are upgrading and have important projects or agents, back up that data first as a precaution.

Choosing the right installer

Mockingjay is distributed in a different package format for each operating system. On Windows, the installer is an .exe or .msi file. On macOS, it is a .dmg disk image. On Linux, you can choose between an .AppImage file, which runs on almost any distribution without installation, a .deb package for Debian and Ubuntu, and an .rpm package for Fedora, Red Hat Enterprise Linux and openSUSE. The Linux formats offered can vary from release to release, so use whichever is published for the version you are installing.

Once you have downloaded the right installer, continue to the Quick Start Guide.

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