# Soika Mockingjay UI Installation and Setup

### System Requirements <a href="#prerequisites" id="prerequisites"></a>

* **Operating System**: Ubuntu 24.04 or newer
* **CPU**: 4 cores or more (recommended)
* **RAM**: 8 GB minimum, 16 GB recommended
* **Storage**: 20 GB free space (minimum)
* **GPU**: NVIDIA GPU with drivers installed (required)
* **Network**: Stable internet connection for installation

Use the following commands to install Soika Mockingjay. Run these commands with sudo as they require administrative privileges.

#### To install the Soika Mockingjay API via Docker:

```bash
curl -sSL https://s3.dualstack.eu-central-1.amazonaws.com/pkg.soika.ai/soika-api/soika-install-docker.sh | sudo bash
```

### Notes

* The installation scripts require an active internet connection to download necessary packages.

### Installation Steps <a href="#installation-steps" id="installation-steps"></a>

Double click on the installer and then follow the step. Once installation is complete follow the below steps.

**Step 1: On opening the app it will prompt for IP address.**

Connect to your Soika server using the appropriate IP address:

![](https://soika-labs.gitbook.io/soika-mockingjay/~gitbook/image?url=https%3A%2F%2F2184813754-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FBSwkgyDGOD52nsc2FrK2%252Fuploads%252FW6esZ1E1AqxbEbQwjNHt%252Fimage.png%3Falt%3Dmedia%26token%3Dd097a188-f7a5-4b5c-a2ba-9222942de527\&width=768\&dpr=4\&quality=100\&sign=1c8a422a\&sv=2)Copy

```
# Replace 192.168.1.100 with your server's actual IP address
192.168.1.100
```

**Step 2: Account Setup**

After installation, you'll need to set up your Mockingjay account:

1. Click on "Setup Account" in the Mockingjay UI section
2. You'll be presented with a registration form
3. Enter the following information:
   * Email address (use a valid email that you have access to)
   * Password (create a strong password)
   * Confirm password
4. Click "Create Account"

**Step 4: Save Your Mnemonic Recovery Phrase**

**Important:** Upon successful account creation, the system will generate a mnemonic recovery phrase.

1. A dialog will appear with your mnemonic recovery phrase
2. This phrase typically consists of 12-24 random words
3. **Copy this phrase and store it securely**
4. Confirm that you've saved the phrase by clicking the checkbox
5. Click "Continue" to proceed

![](https://soika-labs.gitbook.io/soika-mockingjay/~gitbook/image?url=https%3A%2F%2F2184813754-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FBSwkgyDGOD52nsc2FrK2%252Fuploads%252FtrCEU8EqCSB5Y7WOVBh1%252Fimage.png%3Falt%3Dmedia%26token%3Db7371c8b-3631-409a-a20c-6bd95a76622d\&width=768\&dpr=4\&quality=100\&sign=ea00f29a\&sv=2)

> ⚠️ **Warning:** The mnemonic phrase is crucial for account recovery. If you lose this phrase, you may permanently lose access to your account. Store it in a secure location such as a password manager, encrypted file, or even a physically secured written copy.

**Step 5: Verify Your Installation**

To ensure that the Mockingjay UI is properly installed:

1. Log out and log back in to refresh your session
2. Navigate to the main dashboard
3. Look for the Mockingjay section
4. Verify that the UI components load correctly

### Account Recovery <a href="#account-recovery" id="account-recovery"></a>

If you need to recover your account:

1. Click "Recover Account" on the login screen
2. Enter your email address
3. Click "Next"
4. You'll be prompted to enter your mnemonic recovery phrase
5. Enter the phrase exactly as it was provided, with correct spacing
6. Create a new password
7. Click "Recover Account" to complete the process


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://soika-labs.gitbook.io/soika-mockingjay/mockingjay-ui-setup/soika-mockingjay-ui-installation-and-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
