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.
| Component | Windows | macOS | Linux |
|---|---|---|---|
| Operating system | Windows 10 or 11 (64-bit) | A recent macOS release on Apple silicon | A recent 64-bit distribution, such as Ubuntu 22.04+, Debian 12+ or Fedora 38+ |
| Processor | 64-bit multi-core CPU | Apple M-series | 64-bit multi-core CPU (x86_64, or ARM where a build is provided) |
| Memory (RAM) | 16 GB minimum, 24 GB or more recommended | 16 GB minimum, 24 GB or more recommended | 16 GB minimum, 24 GB or more recommended |
| Free storage | 256 GB recommended | 256 GB recommended | 256 GB recommended |
| Display | 1280 × 800 or higher | 1280 × 800 or higher | 1280 × 800 or higher, with a desktop environment such as GNOME or KDE |
| Network | Stable internet connection | Stable internet connection | Stable internet connection |
| Permissions | Rights to install applications | An administrator password | sudo 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.