https://github.com/jordansissel/fpm

Effing package management! Build packages for multiple platforms (deb, rpm, etc) with great ease and sanity.
https://github.com/jordansissel/fpm

Keywords

packaging

Keywords from Contributors

rubygems activerecord chef deployment activejob mvc rack cfgmgt configuration-management discovery

Last synced: about 22 hours ago
JSON representation

Repository metadata

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

Host: GitHub
URL: https://github.com/jordansissel/fpm
Owner: jordansissel
License: other
Created: 2011-01-03T20:07:59.000Z (about 15 years ago)
Default Branch: main
Last Pushed: 2026-01-28T06:20:19.000Z (about 1 month ago)
Last Synced: 2026-02-13T22:49:30.877Z (18 days ago)
Topics: packaging
Language: Ruby
Homepage: http://fpm.readthedocs.io/en/latest/
Size: 2.94 MB
Stars: 11,435
Watchers: 228
Forks: 1,070
Open Issues: 787
Releases: 5
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.rst
- Contributing: docs/contributing.rst
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

README.rst

          fpm
===

|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`_.

.. _the project issue tracker: https://github.com/jordansissel/fpm/issues

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

.. _documentation: https://fpm.readthedocs.io/en/latest/

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

.. _installation guide: https://fpm.readthedocs.io/en/latest/installation.html

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.9 on RHEL 8?" 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

.. include: docs/installing

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

.. include: docs/contributing

.. |Gem| image:: https://img.shields.io/gem/v/fpm.svg
   :target: https://rubygems.org/gems/fpm

Owner metadata

Name: Jordan Sissel
Login: jordansissel
Email:
Kind: user
Description:
Website: http://www.semicomplete.com/
Location: Silicon Valley
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/131818?u=5c20c2ec6386e8d7ecfe940dc34cef0717cede0d&v=4
Repositories: 179
Last ynced at: 2024-04-14T06:39:17.923Z
Profile URL: https://github.com/jordansissel

GitHub Events

Total

Release event: 1
Pull request event: 43
Fork event: 21
Issues event: 29
Watch event: 250
Issue comment event: 134
Push event: 42
Pull request review comment event: 9
Pull request review event: 12
Create event: 11

Last Year

Pull request event: 24
Fork event: 11
Issues event: 17
Watch event: 160
Issue comment event: 87
Push event: 28
Pull request review event: 4
Pull request review comment event: 3
Create event: 7

Committers metadata

Last synced: 13 days ago

Total Commits: 1,955
Total Committers: 351
Avg Commits per committer: 5.57
Development Distribution Score (DDS): 0.457

Commits in past year: 69
Committers in past year: 8
Avg Commits per committer in past year: 8.625
Development Distribution Score (DDS) in past year: 0.246

Name	Email	Commits
Jordan Sissel	j**s@s**m	1061
Daniel Haskin	d**7@g**m	61
Pranay Kanwar	p**r@g**m	53
Jeanine Adkisson	j**n@j**t	31
George Lester	g**1@g**m	30
Nicholas Hubbard	n**d@p**t	23
Paweł Tomulik	p**k@m**l	20
Jan Vansteenkiste	j**n@v**u	18
Remi Hakim	r**i@d**m	15
Aman Gupta	a**n@t**t	15
Matt Sharpe	m**e@g**m	15
Nick Griffiths	n**g@c**z	12
Richard Grainger	g**r@g**m	11
Zsolt Takács	z**t@t**c	9
Tray Torrance	d**k@w**m	8
Chris Gerber	c**r@t**m	8
Jose	j**e@c**m	8
Vedant K	g**2@g**m	7
Thomas Meson	z**k@h**g	7
Lars van de Kerkhof	l**s@p**l	7
Matt Schreiber	E****L	7
Vladimir Rutsky	v**y@t**m	6
Adam Stephens	a**s@d**t	6
Brett Gailey	b**y@d**m	6
Eric Connell	e**l@i**m	6
Jay Buffington	me@j****m	6
Oliver Hookins	o**s@g**m	5
Justin Kolberg	a**t@g**m	5
Emmanuel Bastien	os@e****e	5
Peter Woodman	p**r@s**g	5
and 321 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 14 days ago

Total issues: 157
Total pull requests: 183
Average time to close issues: over 1 year
Average time to close pull requests: 11 months
Total issue authors: 124
Total pull request authors: 97
Average comments per issue: 3.61
Average comments per pull request: 3.0
Merged pull request: 64
Bot issues: 0
Bot pull requests: 0

Past year issues: 14
Past year pull requests: 22
Past year average time to close issues: N/A
Past year average time to close pull requests: 12 days
Past year issue authors: 14
Past year pull request authors: 7
Past year average comments per issue: 3.29
Past year average comments per pull request: 1.41
Past year merged pull request: 6
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/jordansissel/fpm

Top Issue Authors

jordansissel (12)
me21 (5)
jkugler (4)
romulasry (4)
philschwartzsonos (4)
gmabey (3)
mcandre (3)
femiagbabiaka (2)
WilliamDEdwards (2)
robinbowes (2)
wbraswell (2)
kisembo-desire (2)
marcinbarczynski (1)
Ahmedshabaz06 (1)
seiferteric (1)

Top Pull Request Authors

jordansissel (34)
NicholasBHubbard (14)
bugfood (6)
white-gecko (4)
josephholsten (3)
nicobrevin (3)
cwegener (2)
brad (2)
MSMazaya (2)
chayim (2)
JordanStopford (2)
skoef (2)
wheaney (2)
me21 (2)
kduret (2)

Top Issue Labels

deb (1)
windows (1)

Top Pull Request Labels

pending-discussion (3)
docs (1)