Docker for Monalisa

This guide will walk you through the steps to run Monalisa using Docker, enabling you to leverage our library on clusters.

Dockerfile Setup

We provide a Dockerfile that correctly sets up the container for running our functions. This Dockerfile is a modified version based on the official guidelines provided by MathWorks for generating Dockerfiles for MATLAB.

• Reference: MathWorks MATLAB Dockerfile

License Requirements

To use MATLAB remotely via Docker, you must either have access to a license server or possess a license file. Detailed instructions for setting this up can be found here:

• Reference: MATLAB Dockerfile Licensing Information

Steps to Run Monalisa

1. Clone the Repository:

   First, clone the repository containing the necessary files:

   git clone https://github.com/YourRepository/monalisa.git
   

2. Create or Use a Script:

   Create the script you want to run with MATLAB inside the Docker container. As an example, you can use the provided script:

   • Test Script: testDocker.m

3. Build the Docker Image:

   Build the Docker image using the following command. Make sure to replace LICENSE_SERVER with your actual license server information:

   sudo docker build --build-arg LICENSE_SERVER=port@servername -t my_matlab_image_name .
   

4. Run the Docker Image:

   Run the Docker image with the following command, replacing localpathto/recon_eva with your local directory path:

   sudo docker run --init --rm -v localpathto/recon_eva:/usr/src/app/recon_eva my_matlab_image_name
   

Congratulations! You are now running Monalisa in a Docker container.

Note: You will likely build the Docker image locally, push it to Docker Hub, and then pull it on your remote cluster where you will run it. If you are unfamiliar with basic Docker operations, this guide assumes you already have that knowledge, so consider starting with Docker basics if needed.

↑