FEniCS download and installation

The easiest way to install FEniCS is to use our prebuilt, high-performance Docker images. FEniCS can also be installed via package managers or compiled directly from source. Follow the instructions on this page to get started with FEniCS.

The latest stable release of FEniCS is version 2016.1.0, which was released on 2016-06-24. For more information about FEniCS releases and changes, take a look at Release notes for FEniCS. For information on accessing the development repositories, see Contributing.

Docker images (all platforms and versions)   dockerimage

Docker allows us to build and ship consistent high-performance FEniCS installations for almost any platform. To get started, follow these 2 steps:

  1. Install Docker for your platform: Windows, Mac or Linux.

  2. Install the FEniCS Docker script:

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


  • Windows users must (for now) continue to use the Docker Toolbox (not Docker for Windows) if they want to use the fenicsproject script described below.
  • If using the Docker Toolbox (macOS versions < 10.10 or Windows), make sure you run all commands inside the Docker Quickstart Terminal.

Once both Docker and the FEniCS Docker script have been installed, you can easily start a FEniCS session by running the following command:

fenicsproject run

The FEniCS Docker script can also be used to create persistent sessions (fenicsproject create myproject followed by fenicsproject run myproject) or to run different versions of FEniCS (fenicsproject run dev). To see more options, run the following command:

fenicsproject help

For all fenicsproject commands, the contents of the current working directory will be shared into the project at ~/shared.

We regularly release new Docker images with updated versions of FEniCS and its supporting libraries. To upgrade to the latest version, run:

fenicsproject pull

To upgrade to the latest version of the fenicsproject script, run:

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

For more details and tips on how to work with FEniCS and Docker, see our FEniCS Docker page.

Ubuntu packages (stable release)   ubuntuimage

To install FEniCS on Ubuntu, run the following commands:

sudo add-apt-repository ppa:fenics-packages/fenics
sudo apt-get update
sudo apt-get install fenics
sudo apt-get dist-upgrade

This will add our PPA for FEniCS to your package sources and install the latest stable version of FEniCS. Note that FEniCS is also available from the official Ubuntu (and Debian) repositories but may outdated, depending on which release of Ubuntu you are running.

For more details and tips on how to work with FEniCS in Ubuntu, see our FEniCS Ubuntu page.

Manual installation from source (all platforms and versions) toolsimage  

FEniCS can be built manually from source using standard installation mechanisms for Python (Setuptools) and C++ (CMake).

The FEniCS source code is hosted in Git repositories on Bitbucket.

Automatic installation from source (all platforms and versions) toolsimage  

FEniCS can be built automatically from source via HashDist. To build FEniCS, run the following command:

curl -s https://fenicsproject.org/fenics-install.sh | bash

Running this command will build a local installation of FEniCS. Before running the script, you may wish to download and inspect its contents.

For more details and tips on how to work with FEniCS in HashDist, see our FEniCS HashDist page.

Contributed packages

FEniCS is also available through a number of alternative package managers. For information on user contributed binary packages, see our FEniCS contributed packages page.

Data and meshes

A collection of meshes for free use with FEniCS is available here.