Home / Ruby / Package Management

Effing package management! Build packages for multiple platforms (deb, rpm, etc) with great ease and sanity.

fpm The goal of fpm is to make it easy and quick to build packages such as rpms, debs, OSX packages, etc. fpm, as a project, exists to help you build packages, therefore: If fpm is not helping you make packages easily
Information
Category: Ruby / Package Management
Watchers: 238
Star: 10.9k
Fork: 1.1k
Last update: Nov 24, 2023
Resource links
https://github.com/jordansissel/fpm

fpm

Build Chat Gem

The goal of fpm is to make it easy and quick to build packages such as rpms, debs, OSX packages, etc.

fpm, as a project, exists to help you build packages, therefore:

  • If fpm is not helping you make packages easily, then there is a bug in fpm.
  • If you are having a bad time with fpm, then there is a bug in fpm.
  • If the documentation is confusing, then this is a bug in fpm.

If there is a bug in fpm, then we can work together to fix it. If you wish to report a bug/problem/whatever, I welcome you to do on the project issue tracker.

You can find out how to use fpm in the documentation.

You can learn how to install fpm on your platform in the installation guide.

Project Principles

  • Community: If a newbie has a bad time, it's a bug.
  • Engineering: Make it work, then make it right, then make it fast.
  • Capabilities: If it doesn't do a thing today, we can make it do it tomorrow.

Backstory

Sometimes packaging is done wrong (because you can't do it right for all situations), but small tweaks can fix it.

And sometimes, there isn't a package available for the tool you need.

And sometimes if you ask "How do I get python 3 on CentOS 5?" some unhelpful trolls will tell you to "Use another distro"

Further, job switches have me flipping between Ubuntu and CentOS. These use two totally different package systems with completely different packaging policies and support tools. Learning both was painful and confusing. I want to save myself (and you) that pain in the future.

It should be easy to say "here's my install dir and here's some dependencies; please make a package"

The Solution - FPM

I wanted a simple way to create packages without needing to memorize too much.

I wanted a tool to help me deliver software with minimal steps or training.

The goal of FPM is to be able to easily build platform-native packages.

With fpm, you can do many things, including:

  • Creating packages easily (deb, rpm, freebsd, etc)
  • Tweaking existing packages (removing files, changing metadata/dependencies)
  • Stripping pre/post/maintainer scripts from packages

Things that should work

Sources:

  • gem (even autodownloaded for you)
  • python modules (autodownload for you)
  • pear (also downloads for you)
  • directories
  • tar(.gz) archives
  • rpm
  • deb
  • node packages (npm)
  • pacman (ArchLinux) packages

Targets:

  • deb
  • rpm
  • solaris
  • freebsd
  • tar
  • directories
  • Mac OS X .pkg files (osxpkg)
  • pacman (ArchLinux) packages

v1.15.1(Jan 31, 2023)

  • Ruby 3.2.0 now supported. This fixes error 'undefined method exists? for File' '(#1981, #1988; Nicholas Hubbard, romulasry)

v1.15.0(Nov 14, 2022)

  • New flag --fpm-options-file path/to/file which allows you to specify additional fpm flags in an external file of your choosing. (#1905, #1902, #1827; Jordan Sissel, Will Furnell, hjpotter92)
  • deb: Periods are now accepted in package names (#1899; C. Cooke)
  • Fix bug where fpm would crash if --workdir pointed at a path that didn't exist. (#1959; Jordan Sissel)
  • osxpkg: this package format now supports the fpm --prefix flag(#1909, #1908; Jordan Sissel, mcataga)
  • cpan: Fix bug where fpm would fail on certain Perl modules due to their source tarball structure (#1940; Nicholas Hubbard, William N. Braswell, Jr.)
  • cpan: Fix crash on certain CPAN modules where the author field was blank (#1942, #1937, #1523, #1528; Nicholas Hubbard, William N. Braswell, Jr.)
  • deb: The distribution field of the debian changelog and changes files will now use the value set by --deb-dist (default is "unstable") (#1934; Chabert Loïc)
  • python: Fix errors in how fpm invoked pip. Previously, fpm would use pip's --build flag, but this was removed a while ago, and fpm is now aware! (#1896, #1831, #1893, #1916; Jordan Sissel, Svyatogor Chuykov)
  • pleaserun: Add --pleaserun-user flag. (#1912; Evgeny Stambulchik)
  • deb: The default --deb-priority is now "optional" instead of "extra" (#1913; Chris Novakovic)
  • Enable installation of fpm on older versions of ruby. This change removed git rubygem dependency. (#1946, #1923; Jordan Sissel, Andreas Wirooks, Ruslan Kuprieiev, jamshid, Lorenzo Castellino, Sam Hughes)
  • Enable operation of fpm on very old versions of ruby (as old as Ruby 1.9.3). This changed removed json rubygem dependency. (#1950, #1949, #1741, #1264, #1798, #1800, #1784; Jordan Sissel and many others)
  • Fix bug where subprocesses could hang waiting for input (#1955, #1519, #1522; Nicholas Hubbard, William N. Braswell, Jr.)
  • Update Dockerfile to use ubuntu:20.04 (#1935; Gnought)
  • internal: Fix a code typo (#1948; Nicholas Hubbard)
  • internal tests: Support newer versions of lintian (#1939, #1907; Jordan Sissel)
  • Improve support for Ruby 3.1.0 and newer that would previously crash with an error mentioning Psych::DisallowedClass (#1898, #1895; Jordan Sissel, Alexandre ZANNI)
  • Improve support for Ruby 3.1.0 and newer that changed the API for ERB (#1897; Jordan Sissel)

v1.14.0(Nov 10, 2021)

Major documentation rewrite for this version. I hope it makes things easier to learn and find! https://fpm.readthedocs.io/en/v1.14.0/

FreeBSD bug fix, python now uses pip by default, and a few other nice improvements listed below:

Changes

  • python: Use pip by default for fetching Python packages. This matches the Python 3 "installation" docs which recommend calling pip as python -m pip where python depends on --python-bin (default "python"). Previous default was to use easy_install which is no longer available on many newer systems. To use easy_install, you can set --no-python-internal-pip to revert this pip default. Further, you can specify your own pip path instead of using python -m pip with the --python-pip /path/to/pip flag. (#1820, #1821; Jordan Sissel)
  • python: Support extras_require build markers in python packages (#1307, #1816; Joris Vandermeersch)
  • freebsd: Fix bug which caused fpm to generate incorrect FreeBSD packages "missing leading /" (#1811, #1812, #1844, #1832, #1845_; Vlastimil Holer, Clayton Wong, Markus Ueberall, Jordan Sissel)
  • deb: In order to only allow fpm to create valid packages, fpm now rejects packages with invalid "provides" (--provides) values. (#1829, #1825; Jordan Sissel, Peter Teichman)
  • deb: Only show a warning about /etc and config files if there are files in /etc (#1852, #1851; Jordan Sissel)
  • rpm: replace dash with underscore in rpm's "Release" field aka what fpm calls --iteration. (#1834, #1833; Jordan Sissel)
  • empty: fpm -s empty ... now defaults to "all" architecture instead of "native". (#1850, #1846; Jordan Sissel)
  • Significant documentation improvements rewriting most of the documentation. New overview pages, full CLI flag listing, and new sections dedicated package types (rpm, cpan, deb, etc). (#1815, #1817, #1838_; Vedant K, Jordan Sissel)
  • Typo fixes in documentation are always appreciated! (#1842_; Clayton Wong)
  • fpm can now (we hope!) now be tested more easily from docker (#1818, #1682, #1453_; @directionless, Jordan Sissel, Douglas Muth)

Contents

    knqyf263 A golang library for parsing deb package versions
    goreleaser NFPM is Not FPM - a simple deb and rpm packager written in Go
    karpathy arxiv-sanity, but very lite, simply providing the core value proposition of the ability to tag arxiv papers of interest and have the program recommend similar papers.
    ricokahler Generate TypeScript types from your Sanity schemas
    ryanfortner Super simple script to create a deb file
    SimeonGriggs Automated backups from Sanity to AWS S3
    rpm-software-management A tool for managing rpm based git projects.
    Netflix A tool for creating EBS AMIs. This tool currently works for CentOS/RedHat Linux images and is intended to run on an EC2 instance.
    Jesperpaulsen An NPM package written in React used to preview mobile devices. Especially helpful when used in combination with a CMS like sanity.
    a-rodin Build production quality deb packages for patched NGINX with ease
    rohanrhu ☕ GDBFrontend is an easy, flexible and extensionable gui debugger.
    txn2 Go library and CLI utilty for /etc/hosts management.
    ricokahler The Sanity Desk Tool Pane with Super Powers
    urllib3 Python HTTP library with thread-safe connection pooling, file post support, sanity friendly, and more.
    spiritsec log4j hunter helper - Compatible with Deb, Redhat and Suse, and other ready for ansible and other automations that uses exit code for DevOps integration with existing tools
    udoprog checkers - A sanity checker for global allocations
    NicolasDorier Helping you to block mainstream media to keep your sanity
    unjs 📙 UnJS standard library - This package aggregates a collection of useful packages from unjs for ease of use.
    RedpointArchive A CLI tool for signing and verifying npm and yarn packages.
    WireGuard Package wgctrl enables control of WireGuard interfaces on multiple platforms.
    oracle Smith: A microcontainer builder
    Share this repo

    Related Repos


    Package Management
    2k
    Emacs Plus formulae for the Homebrew package manager
    d12frosted Emacs Plus is → GNU Emacs formulae for macOS → Homebrew package manager. It offers a wide rage of extra functionality over regular → Emacs package.
     
    Popular
    Package Management
    37.8k
    🍺 The missing package manager for macOS (or Linux)
    Homebrew Homebrew Features, usage and installation instructions are summarised on the homepage. Terminology (e.g. the difference between a Cellar, Tap, Cask and so forth) is explained here. Update Bug If Homebrew was updated o
     
    Package Management
    122
    Find source repositories for ruby gems. Open, compare, and update outdated gem versions
    teeparham gemdiff gemdiff is a command-line tool to find source code for ruby gems. It connects gem version management (rubygems + bundler) with source code (GitHub). gemdiff provides commands to Find GitHub repositories for gems
     
    Package Management
    1.1k
    A Chef Cookbook manager
    berkshelf Berkshelf Manage a Cookbook or an Application's Cookbook dependencies Installation Berkshelf is now included as part of the Chef-DK. This is fastest, easiest, and the recommended installation method for getting up
     
    Popular
    Package Management
    14.3k
    The Cocoa Dependency Manager.
    CocoaPods CocoaPods: The Cocoa dependency manager CocoaPods manages dependencies for your Xcode projects. You specify the dependencies for your project in a simple text file: your Podfile. CocoaPods recursively resolves dependencies
     
    Package Management
    10.9k
    Effing package management! Build packages for multiple platforms (deb, rpm, etc) with grea...
    jordansissel fpm The goal of fpm is to make it easy and quick to build packages such as rpms, debs, OSX packages, etc. fpm, as a project, exists to help you build packages, therefore: If fpm is not helping you make packages easily
     
    Package Management
    27.1k
    💀 The former home of Homebrew/homebrew (deprecated)
    Homebrew Homebrew (Legacy) This repository has been deprecated and split into two repositories: Homebrew formulae/packages: Homebrew/homebrew-core (former contents of Library/Formula) Homebrew package manager: Homebrew/brew Pleas