Installing OpenCARP with Docker 🐳

1

Installing OpenCARP with Docker :spouting_whale:

In this article we will go through how to install OpenCARP (a software for Cardiac Electrophysiology simulation) using Docker.

Docker is a container that packages software and all of its requirements so it can run the same way on any computer.

There is an official guide for this openCARP Docker installation if you are command-line savvy:

1) Install Docker Desktop

  1. Go to the website: https://www.docker.com/products/docker-desktop/
  2. Download Docker Desktop for your computer (Windows or Mac).
  3. Install it:
  • Windows: double-click the file you downloaded and follow “Next, Next, Finish.”
  • Mac: drag the Docker icon into Applications.
  1. Open Docker Desktop (you’ll see a little whale icon in your tray/bar).
  2. The first time you run it, it may ask you to sign in (or make a free Docker account).

Downloading docker desktop
Downloading docker desktop1544×855 171 KB

2) Set up openCARP in Docker

If you are new to terminal, don’t worry, you’ll just copy-paste the commands and press enter).

  1. Open a terminal/command prompt on your computer.
  • Windows: search for “PowerShell” in the Start menu.
  • Mac: open “Terminal” from Applications → Utilities.
  1. Download openCARP with Docker:
    Type the following into the terminal window.
    docker pull docker.opencarp.org/opencarp/opencarp:latest

Docker command to install openCARP
Docker command to install openCARP1920×1150 29.7 KB

  1. Run openCARP:
    Type the following into the same terminal window.
    docker run -it docker.opencarp.org/opencarp/opencarp:latest

  2. Check it works:
    Type the following into the same terminal window.
    carputils check
    If you see a message, it means openCARP is installed and ready to go!

3) Using openCARP

You can now use openCARP through the command line (writing commands in the terminal) or using an interface like EP Workbench software.

For example you can have a look at the examples by going into the folder:
Type the following into the same terminal window.

cd /openCARP/examples

Thank you.