# Quick start

### Here, you’ll find instructions to download and install the MEDomics platform for your specific operating system.

{% hint style="info" %}
Please [contact us](/medomics-docs/forms/contact-us.md) if you face any issues during the installation.
{% endhint %}

{% tabs %}
{% tab title="Windows" %}
{% embed url="<https://youtu.be/1F7Yg78FXVE>" %}
MEDomics installation guide on Windows
{% endembed %}

{% hint style="warning" %}
The platform was tested on Windows 10 and 11.&#x20;
{% endhint %}

Access the download page [here](https://medomics.app/#download).
{% endtab %}

{% tab title="Ubuntu" %}
{% embed url="<https://youtu.be/Erz_dNBcjV0>" %}
MEDomics installation guide on Ubuntu
{% endembed %}

{% hint style="warning" %}
The platform was tested on Ubuntu 22.04 and 24.04.
{% endhint %}

Access the download page [here](https://medomics.app/#download).
{% endtab %}

{% tab title="MacOS " %}
{% hint style="info" %}
A video tutorial for the MEDomics installation on macOS is in the making. In the meantime, please follow the instructions below.
{% endhint %}

{% hint style="warning" %}
The platform was tested on Tahoe (26.0) with M3 and M4 chips.&#x20;
{% endhint %}

Follow these steps to install MEDomics on your macOS system. You'll need to download both the `.pkg` and `.dmg` installation files.

### Prerequisites

* macOS 10.15 (Catalina) or later
* Administrator privileges on your Mac
* Sufficient disk space (minimum 5 GB recommended)

### Installation Steps

{% hint style="info" %}
All the installation files can be downloaded from [here](https://medomics.app/#download).
{% endhint %}

#### 1. Install Python Environment and MongoDB

1. **Download the `.pkg` installer** from the official MEDomics website
2. **Locate the downloaded file** in your Downloads folder
3. **Double-click the `.pkg` file** to start the installation
4. **Follow the installation wizard**:
   * Click **Continue** for each step
   * Click **Agree** to accept the license terms
   * Click **Install** when prompted
5. **Enter your Mac password** when prompted for administrator approval
6. **Click "Allow"** if macOS displays a security prompt
7. **Wait for the installation to complete** (this may take several minutes)
8. Click **Close** once the installation is successful.

#### 2. Install the MEDomics Application

1. **Download the `.dmg` file** (if not already downloaded)
2. **Double-click the `.dmg` file**
3. **Drag the MEDomics icon** to your Applications folder when prompted
4. **Wait for the copy process to complete**

#### 3. Launch MEDomics

1. **Open your Applications folder**
2. **Double-click the MEDomics icon** to launch the application
3. **If prompted about an unidentified developer**:
   * Go to **System Preferences → Security & Privacy**
   * Click **"Open Anyway"** next to the MEDomics warning

### Troubleshooting

| Issue                                   | Solution                                                              |
| --------------------------------------- | --------------------------------------------------------------------- |
| "Cannot verify developer"               | Go to System Preferences → Security & Privacy and click "Open Anyway" |
| Installation hangs                      | Restart your Mac and try again                                        |
| Python environment pr MongoDB not found | Reinstall the `.pkg` file                                             |

### Need Help? [Contact us](/medomics-docs/forms/contact-us.md).

{% endtab %}
{% endtabs %}

## The MEDomics platform is now installed on your system!

{% hint style="warning" %}
If you [delete the app](https://medomics-udes.gitbook.io/medomicslab-docs/troubleshooting#how-to-remove-the-app), you must also delete the .medomics folder located in your user's folder, in order to remove the MEDomics Python environment.
{% endhint %}


---

# 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://medomicslab.gitbook.io/medomics-docs/quick-start.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.