Installing fpm¶

This how-to guide covers the installation of Fortran on various platforms.

MSYS2 package manager¶

The MSYS2 project provides a package manager and makes many common Unix tools available for Windows.

Note

To install download the msys2-x86_64-YYYYMMDD.exe installer from the MSYS2 webpage and run it. MSYS2 will create several new desktop shortcuts, like MSYS terminal, MinGW64 terminal and UCRT64 terminal (more information on MSYS2 terminals are available here).

The Fortran package manager is supported for the the UCRT64, MinGW64, or MinGW32 terminal.

Open a new terminal and update your installation with

pacman -Syu

You might have to update MSYS2 and pacman first, restart the terminal and run the above command again to update the installed packages.

If you are using the MinGW64 terminal you can install the required software with

pacman -S git mingw-w64-x86_64-gcc-fortran mingw-w64-x86_64-fpm

Tip

Both git and gfortran are not mandatory dependencies for running fpm. If you provide git and gfortran from outside they will get picked up as well.

Homebrew package manager¶

The Fortran package manager (fpm) is available for the homebrew package manager on MacOS via an additional tap. To install fpm via brew, include the new tap and install it using

brew tap awvwgk/fpm
brew install fpm

Binary distributions are available for MacOS 11 (Catalina) and 12 (Big Sur) for x86_64 architectures. For other platforms fpm will be built locally from source automatically.

Fpm should be available and functional after those steps.

Conda package manager¶

Fpm is available on conda-forge, to add conda-forge to your channels use:

conda config --add channels conda-forge

Fpm can be installed with:

conda create -n fpm fpm
conda activate fpm

Alternatively, if you want fpm to be always available directly install into your current environment with

conda install fpm

Note

The conda package manager can be installed from miniforge or from miniconda.

Arch Linux user repository¶

The Arch Linux user repository (AUR) contains two packages for the Fortran package manager (fpm). With the fortran-fpm-bin installs the statically linked Linux/x86_64 binary from the release page, while the fortran-fpm package will bootstrap fpm from source.

Select one of the PKGBUILDs and retrieve it with

git clone https://aur.archlinux.org/fortran-fpm.git
cd fortran-fpm

As usual, first inspect the PKGBUILD before building it. After verifying the PKGBUILD is fine, build the package with

makepkg -si

Once the build passed pacman will ask to install the fpm package.

Building from source¶

To build fpm from source get the latest fpm source, either by cloning the repository from GitHub with

git clone https://github.com/fortran-lang/fpm
cd fpm

or by downloading a source tarball from the latest source

wget https://github.com/fortran-lang/fpm/archive/refs/heads/main.zip
unzip main.zip
cd fpm-main

The available install script allows to bootstrap fpm by using just a Fortran compiler, git and network access. Invoke the script to start the bootstrap build

./install.sh

Fpm will be installed in ~/.local/bin/fpm.

Note

Building the bootstrapper binary from the single source file version might take a few seconds, which might make the install script look like it is hanging.

Tip

The installation location can be adjusted by passing the --prefix=/path/to/install option.

If you can’t run the install script, you can perform the bootstrap procedure manually, with the following three steps:

Download the single source version of fpm

wget https://github.com/fortran-lang/fpm/releases/download/current/fpm.F90

Build a bootstrap binary from the single source version

mkdir -p build/bootstrap
gfortran -J build/bootstrap -o build/bootstrap/fpm fpm.F90

Use the bootstrap binary to build the feature complete fpm version
```
./build/bootstrap/fpm install
```