# MOTAR QuickStart

<figure><img src="/files/f6vJ57ORJGJd3TKeXDz2" alt=""><figcaption></figcaption></figure>

## Launching MOTAR QuickStart

**MOTAR QuickStart** *runs the same regardless of your system, with some minor differences for Windows.*

{% hint style="warning" %}
Running MOTAR QuickStart requires **Admin** privleges on the computer used to run MOTAR and update networking files.

If you did not run the installer as administrator, you will be prompted to continue without Admin privleges, this may cause some networking issues with the install.&#x20;

Select **NO** and then restart MOTAR QuickStart as an administrator.
{% endhint %}

<details>

<summary>Windows</summary>

* **Unpack** the zip file, if applicable
* Right Click the **MOTAR\_QuickStart.exe** file and select **"Run as Administrator"**
* You may be prompted to allow the Installer to run. Select **YES**

<figure><img src="/files/5aDYRJS8bgIp6KzhuyVn" alt="" width="375"><figcaption></figcaption></figure>

</details>

<details>

<summary>Mac/Linux</summary>

* Open Terminal and run the following command:

\*replace "/Downloads/" with the directory where you downloaded the installer.

```
sudo ./~/Downloads/MOTAR_QuickStart-darwin-arm64
```

</details>

***

## Using MOTAR QuickStart&#x20;

{% hint style="info" %}

### Installer Utility Note

The MOTAR Installer is a persistent utility. Retain the executable file to manage your instance, including starting, stopping, updating, or removing the platform.
{% endhint %}

#### Install MOTAR

* Select **Install MOTAR**

<figure><img src="/files/k7Th2DoTEpZD1dNIpmuZ" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}

### WARNING

***MOTAR** on Windows uses **Windows Subsytem for Linux** (WSL). If WSL is not found, you will be prompted to install WSL.* Follow the instructions in [#wsl-not-installed](#wsl-not-installed "mention")
{% endhint %}

<figure><img src="/files/bRHVs1UEmasvnTe3nB56" alt="" width="563"><figcaption></figcaption></figure>

* During installation several Command/Terminal windows may open, do not close these windows. They will close automatically.

<figure><img src="/files/5212ApWhUdUrbuInyp8m" alt="" width="563"><figcaption></figcaption></figure>

* When the Installer is finished (indicated by the :white\_check\_mark:), you can open your MOTAR page by clicking "**Open MOTAR**"

<figure><img src="/files/hsOfXbkA35QUHeGWVHyZ" alt=""><figcaption></figcaption></figure>

* Your default browser will open and the MOTAR configuration page will be shown.
* Enter your details and upload your **Discovery license**.&#x20;

{% hint style="info" %}
The user/password you create here will be your admin for your MOTAR test instance, keep it handy!
{% endhint %}

<figure><img src="/files/BwEfjQ6wA7LwOfkjxTlo" alt=""><figcaption></figcaption></figure>

#### Finalize MOTAR Setup

Fill out the information on the set up screen including a user name and password. Save this as it will be your first administrator user on the platform.

#### Congratulations!&#x20;

Your MOTAR Instance is now ready to add test content!

Using the MOTAR demo content? Follow our guide here: [MOTAR Tutorials](/welcome/motar-tutorials.md)

Adding your own content? See our guides here: [ADDITIOINAL FEATURES](/additioinal-features/motar-3d.md)

### **Issues**?&#x20;

See [#troubleshooting](#troubleshooting "mention")

***

## Additional Features

### Update MOTAR

Updating MOTAR is a simple process requiring only two clicks.&#x20;

**Click "**&#x53;top MOTAR" to **stop** the instance.

<figure><img src="/files/y2mR6tixgy0IBHI2bIPS" alt="" width="563"><figcaption></figcaption></figure>

**Click** "Update MOTAR" to **update** your instance to the latest version (if available).

<figure><img src="/files/WA5aDo9NlYY6bfJREwTb" alt="" width="563"><figcaption></figcaption></figure>

MOTAR will automatically start back up after the update is complete.

***

### Remove MOTAR

Removing MOTAR is a simple button click.

{% hint style="warning" %}

#### Don't Lost Your Data!

Did you use your own content to populate MOTAR and are moving to a fully deployed production version? Before you remove MOTAR, follow this guide to backup your data and import into the new instance!

[Broken mention](broken://pages/QByNki2DLeUSI013uSpN)
{% endhint %}

To remove MOTAR from your local system, simply launch the installer and **click** "Remove MOTAR"

<figure><img src="/files/Vjy7SNd2IEK60TMrPDwW" alt="" width="563"><figcaption></figcaption></figure>

* Confirm "**Yes**" to the popup

<figure><img src="/files/Pxr1MX6stCHSPlALnvP2" alt="" width="563"><figcaption></figcaption></figure>

* All files will be removed and the system will be restored to the original state.

<figure><img src="/files/whGdzUdrHZelrznD4WLK" alt="" width="563"><figcaption></figcaption></figure>

***

### Start/Stop Containers

You can start and stop your MOTAR instance without affecting your test data or assets. If you need to stop MOTAR or just want to spin it down between tests, simply click on the **Stop** button. MOTAR will be stopped with no loss of data.

Ready to start testing again? Simply run the **QuickStart** installer and click **Start**. MOTAR will startup after a few moments and you can continue the demo.

<figure><img src="/files/y2mR6tixgy0IBHI2bIPS" alt="" width="563"><figcaption></figcaption></figure>

***

### Open MOTAR

**Click** the "Open MOTAR" button to launch the MOTAR webpage in your default browser.

<figure><img src="/files/IPqwWhonym5ZwMdvXvWd" alt="" width="563"><figcaption></figcaption></figure>

***

## Troubleshooting

A small guide of solutions to common errors you may encounter during installation.

<details>

<summary><strong>I got the warning "Admin Privileges Required"</strong></summary>

* MOTAR Installer requires Admin privleges to run, select **NO** if prompted&#x20;

<figure><img src="/files/6yPsWjDJi0eLHx1OoUzy" alt="" width="375"><figcaption></figcaption></figure>

**Windows**

* Close the installer and restart as **Admin** *(right click on the installer file and select "Run as Administrator").*

<figure><img src="/files/auGhMRmfW5UBXlqhwsIW" alt="" width="336"><figcaption></figcaption></figure>

**Mac/Linux**

* Close the installer and restart using "sudo"

```
sudo ./~/<your file location>/MOTAR_QuickStart-darwin-arm64
```

</details>

<details>

<summary><strong>I got the warning "WSL Not Installed" on Windows</strong></summary>

MOTAR **requires** Windows Subsystem for Linux (**WSL**) to be installed on the computer. You can learn about WSL from the official Microsoft site: <https://learn.microsoft.com/en-us/windows/wsl/about>

{% hint style="info" %}
**Windows Subsystem for Linux (WSL)** is a Microsoft feature that allows developers and users to run a GNU/Linux environment directly on Windows. It lets you install and run Linux command-line tools, utilities, and applications without needing a separate virtual machine or dual-boot setup.
{% endhint %}

During the initial run, the installer will check your system for WSL, if not found, you will see the following message:

<figure><img src="/files/T88EyrqyplOhnZTxpBst" alt="" width="375"><figcaption></figcaption></figure>

To install WSL (Windows Subsystem for Linux):

* Open a new PowerShell window as **ADMIN**
* Type:&#x20;
  * ```
    wsl --install -d Ubuntu-24.04
    ```
* Ubuntu WSL will install on your machine.&#x20;
* You will be prompted by the installer to create a username/password. The WSL installer will default to your Windows username. Make note of your username and password, you'll need this to remove MOTAR later!

{% hint style="danger" %}
When entering a password, you will not see any indication that you are typing. This is normal behavior, be sure to make note of your password, as you may need it later.
{% endhint %}

{% hint style="warning" %}
If you are on Windows 10 you may be prompted for a reboot. If this happens, simply rerun the MOTAR Installer after reboot.
{% endhint %}

* Once WSL is installed on your machine, **rerun** the MOTAR Installer.

</details>


---

# 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://docs.motar.com/welcome/getting-started/local-installation/motar-quickstart.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.