# \[AIAB-00] Setup your Linux box

This section describes how to build a fresh Ubuntu 20.04 VM on your workstation with a few commands using Multipass.

Notice: another option to install Akamas is using a VM running a freshly installed Ubuntu 20.04 or RHEL / CentOS 8 on your workstation or cloud service provider of choice. If this is the case you can skip this section.

Notice that, as of the date of this document, Multipass is not yet supported on macOS for Apple M1-based computers.

#### Multipass Overview <a href="#user-content-multipass-overview" id="user-content-multipass-overview"></a>

The following picture represents the high-level architecture of how Akamas operates in this scenario. As this picture illustrates, the Akamas commands in this guide need to be executed from an Akamas shell in the VM while those related to Multipass need to be executed from a shell on your workstation (the host running the VM).

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

#### Install Multipass

First of all, get Multipass installed by following the instructions on the [multipass website](http://multipass.run). Multipass is a lightweight VM manager that provides the fastest way to create an Ubuntu VM on [Linux](https://multipass.run/docs/installing-on-linux), [Windows](https://multipass.run/docs/installing-on-windows), or [macOS](https://multipass.run/docs/installing-on-macos).

If you already use VMware or VirtualBox, it is better to create a new VM starting from the Ubuntu ISO, since Multipass may conflict with your current virtualization setup. If you are not currently using any other virtual machine, then you should be fine.

#### Create your VM with Multipass <a href="#user-content-create-your-vm-with-multipass" id="user-content-create-your-vm-with-multipass"></a>

Duration: 01:00

Once Multipass is installed, you can create an Ubuntu 20.04 instance with the resources required by Akamas by executing the following command:

```bash
multipass launch -c 2 -m 8G -d30G -n akamas
```

Once this step is complete, you can check the instance IP (note this down, it will be required later)

```bash
multipass list
```

Now you can launch a shell logged into this instance:

```bash
multipass shell akamas
```


---

# 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.akamas.io/quick-guides/quick-guides-akamas-in-a-box/aiab-00-install-akamas-in-a-box/aiab-00-setup-your-linux-box.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.
