# 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](https://medomicslab.gitbook.io/medomics-docs/~/revisions/z0wFwbRqAmxlgbHR1M4e/forms/contact-us) 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](https://medomicslab.gitbook.io/medomics-docs/~/revisions/z0wFwbRqAmxlgbHR1M4e/forms/contact-us).

{% 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 %}