Try our demo website 🔗

Before downloading OpenMOLE, you might want to get a preview of what you can do with it. You can try OpenMOLE online using our demo website. Please note that the service is reset every 6 hours, so don't be surprised if your current script suddenly vanishes :-)

Install OpenMOLE 🔗

Prerequisites 🔗

• A Linux System: OpenMOLE runs on Linux, in order to run it on other systems please consider using the docker package
• Java >= 11: to run on your own computer, OpenMOLE requires Java version 11 or above. Check our FAQ to access your Java version information
• Node.js: to run on your own computer, OpenMOLE GUI requires Node.js
• Singularity: most of OpenMOLE tasks require the Singularity container system

NB: If you have docker installed on your computer, the most convenient way to run OpenMOLE might be to run OpenMOLE in docker.

Download 🔗

When Java and Node.js are installed, you just need to download and extract the archive below, and you're done! OpenMOLE is installed and works out of the box!
Download 17.2 - Xtreme Xploration
The version 17.2, named Xtreme Xploration, has been released on September 24, 2024 After downloading OpenMOLE, you can launch it by executing the openmole file in the installation directory with the ./openmole command. It will bring up you web browser and you should see something like this: OpenMOLE supports Chrome and Firefox. If you are using another web browser, you will need to copy paste the OpenMOLE URL (something like http://localhost:[port] in either Chrome or Firefox.
To get help an installing OpenMOLE, get in touch with us through the OpenMOLE chat.

Experiment with OpenMOLE 🔗

To get started with OpenMOLE and see a few simple use cases, you can follow our Step by Step Introduction to OpenMOLE. Other Tutorials are also available, and you should find all the info you need in our Documentation section.
If you have questions or problems, don't hesitate to contact our great community through the forum or the chat!

Alternative Install 🔗

Run in Docker 🔗

You can run OpenMOLE using a Docker container published on the Docker Hub. Running OpenMOLE using Docker images facilitates the execution of multiple instances of OpenMOLE on different ports, possibly with different versions. It also facilitates the automatic restart of OpenMOLE or its update for a newer version.
You can run it using docker or docker-compose. In one line you can run:

#replace $USER_DIR with a directory value in which your data will be stored
docker run --privileged -p 8080:8080 -h openmole -v $USER_DIR:/var/openmole/ openmole/openmole:17.2

You should be able to access OpenMOLE by opening http://localhost:8080 in your browser.
In order to use the latter, follow these steps:

• install docker-compose: follow the Docker documentation to install it on your system,
• create a docker-compose.yml file in a directory containing the information found on the Docker Hub,
• edit the docker-compose.yml file as explained below,
• pull the Docker image by running sudo docker-compose pull,
• start the Docker image by running sudo docker-compose up -d,
• stop the Docker image by running sudo docker-compose down,
• monitor the Docker image by running sudo docker-compose top, sudo docker-compose ps, or sudo docker-compose logs -t.

In general, report to the @code{docker-compose} documentation and your favorite search engine to solve your problems.
The following docker-compose configuration runs the 17.2 OpenMOLE version. It displays the OpenMOLE web user interface on port 55555, and mounts the local directory ./data/openmole as the directory for OpenMOLE settings and results. It also restarts automatically on failure.

version: "3"
  services:
    openmole:
      image: openmole/openmole:17.2
      hostname: openmole
      volumes:
        - ./data/openmole:/var/openmole/
      ports:
        - "55555:8080"
      privileged: true

To set some OpenMOLE parameters (for instance an http proxy) you can do:

version: "3"
  services:
    openmole:
      image: openmole/openmole:17.2
      hostname: mymachinenetworkname.mydomain.org
      command: openmole-docker --proxy http://myproxy.mydomain.org:3128
      volumes:
        - ./data/openmole:/var/openmole/
      ports:
        - "55555:8080"
      privileged: true
      restart: on-failure:100000

Multi-user OpenMOLE server 🔗

A multi-user OpenMOLE server host base on k3S has been developed. The instruction to deploy it are not available yet, but if you require such a sever for your lab or your company, please get in touch with us.

Build From Sources 🔗

If you prefer building the OpenMOLE application from sources you can do so as explained here.

Get a previous version 🔗

Previous versions of the OpenMOLE application and documentation are available here. The previous versions logs are gathered here.