Download

Suggest edits
Documentation

Content:

1 - Try our demo website
2 - Install OpenMOLE
3 - Experiment with OpenMOLE
4 - Alternative Install


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 🔗

  • 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: some OpenMOLE tasks require the Singularity container system. You must install it on your system if you want to use some tasks such as Python, R, Scilab, Container.

NB: If you have docker installed on your computer, the most convient 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.0-SNAPSHOT - W... W...
The version 17.0-SNAPSHOT, named W... W..., has been released on May 16, 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.

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 🔗

Build From Sources 🔗

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

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 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.0-SNAPSHOT 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.0-SNAPSHOT
      hostname: openmole
      volumes:
        - ./data/openmole:/var/openmole/
      ports:
        - "55555:8080"
      privileged: true
      restart: on-failure:100000
To set some OpenMOLE parameters (for instance an http proxy) you can do:
version: "3"
  services:
    openmole:
      image: openmole/openmole:17.0-SNAPSHOT
      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

Get a previous version 🔗

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