Installation

FPM is written in ruby and can be installed using gem. For some package formats (like rpm and snap), you will need certain packages installed to build them.

Installing FPM

Note

You must have ruby installed on your machine before installing fpm. Here are instructions to install Ruby on your machine.

You can install FPM with the gem tool:

gem install fpm

To make sure fpm is installed correctly, try running the following command:

fpm --version

You should get some output like this, although the exact output will depend on which version of FPM you have installed.:

% fpm --version
1.14.0

Now you can go on to using FPM!

Installing optional dependencies

Warning

This section may be imperfect; please make sure you are installing the right package for your OS.

Some package formats require other tools to be installed on your machine to be built; especially if you are building a package for another operating system/distribution.

  • RPM: rpm/rpm-tools/rpm-build [This dependency might be removed in the future, see issue #54 on github]
  • Snap: squashfs/squashfs-tools

Note

You will not be able to build an osxpkg package (.pkg) for MacOS unless you are running MacOS.

Here are instructions to install these dependencies on your machine:

On OSX/macOS:

brew install rpm squashfs

On Arch Linux and Arch-based systems (Manjaro, EndeavourOS, etc):

pacman -S rpm-tools squashfs-tools

On Debian and Debian-based systems (Ubuntu, Linux Mint, Pop!_OS, etc):

apt-get install squashfs-tools

On Red Hat systems (Fedora 22 or older, CentOS, Rocky Linux, etc):

yum install rpm-build squashfs-tools

On Fedora 23 or newer:

dnf install rpm-build squashfs-tools

On Oracle Linux 7.x systems:

yum-config-manager --enable ol7_optional_latest
yum install rpm-build squashfs-tools