> For the complete documentation index, see [llms.txt](https://hs764.gitbook.io/cee-5735/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hs764.gitbook.io/cee-5735/fenics/docker.md).

# Getting started

## On this page:

1. [Linux/MacOS](/cee-5735/fenics/docker.md#linux-mac)
2. [Windows](/cee-5735/fenics/docker.md#windows)
3. [Ubuntu](/cee-5735/fenics/docker.md#ubuntu)

## Linux/Mac

#### Using Anaconda (Recommended)

The easiest way to use FEniCS is by creating and activating a conda environment containing the FEniCS package:

```
conda create -n fenicsproject -c conda-forge fenics
source activate fenicsproject
```

#### Using Docker

Another way is to download the FEniCS Docker image and set up a Docker container. Please note that there are additional steps if you wish to use Jupyter Notebook inside a Docker container. 

Installing Docker is pretty straightforward on MacOS:

{% embed url="<https://docs.docker.com/docker-for-mac/install/>" %}

After installing Docker, download the FEniCS Docker image from your terminal:&#x20;

```
curl -s https://get.fenicsproject.org | bash
```

Using this image, create a container named *fenics-container* (or name it however you like) that shares files with your local directory:

```
docker run -ti -v $(pwd):/home/fenics/shared --name fenics-container -p 127.0.0.1:8000:8000 quay.io/fenicsproject/stable
```

Navigate to your desired local directory and start the Docker container:

```
docker start fenics-container
docker exec -ti -u fenics fenics-container /bin/bash -l
```

This is what you can expect on your terminal. Notice that the *shared* directory in the container shares the same files as your local directory.&#x20;

![](/files/-MMWbhiR7OD_wM7lv-W0)

Run your python scripts normally using *python3*. When you are finished, first exit the container using *exit,* then stop the Docker container:

```
docker stop fenics-container
```

## Windows

#### **Using Docker**

Docker for Windows requires Windows 10 [Pro/Enterprise/Education ](https://docs.docker.com/docker-for-windows/install/)or [Home](https://docs.docker.com/docker-for-windows/install-windows-home/). After installation, follow the steps above to create a FEniCS container. Docker for Windows can be a bit finicky since it uses Hyper-V or WSL2 to run the Linux images. If you've tried this installation and failed, I would recommend using Ubuntu.

#### **Using Ubuntu (Recommended)**

There are many ways to use Ubuntu on a Windows PC (via virtual machine, dual booting, cloud, etc.). If you don't have a preference, I would recommend setting up an Ubuntu virtual machine.&#x20;

First install Virtualbox:

{% embed url="<https://www.virtualbox.org/wiki/Downloads>" %}

Then follow these instructions to set up a Ubuntu virtual machine:

{% embed url="<https://www.cs.unm.edu/~bradykey/ubuntuVMInstallGuide.html>" %}

Finally, install FEniCS on the Ubuntu VM using the instructions in the Ubuntu section.&#x20;

## Ubuntu

Install FEniCS by running this on the terminal:

```
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:fenics-packages/fenics
sudo apt-get update
sudo apt-get install --no-install-recommends fenics
```

{% hint style="warning" %}
If line 4 fails, try running lines 3 and 4 again.
{% endhint %}