rc file (dotfile) management
Perl Shell Perl6 Makefile Ruby M4
Latest commit ee63185 Mar 1, 2016 @BKStephens BKStephens committed with mike-burns Add installation instructions for Korora
Korora can make use of Fedora packages by specifying the version and
architecture explictly.

Rephrased by Mike Burns for consistency.

Closes #176.



This is a management suite for dotfiles. See the tutorial to get started quickly.

It assumes that you have a separate dotfiles directory, or are interested in creating one.

The programs provided are rcup(1), mkrc(1), rcdn(1), and lsrc(1). They are explained in the tutorial and configured using rcrc(5).


Arch Linux:



wget https://thoughtbot.github.io/rcm/debs/rcm_1.3.0-1_all.deb
sha=$(sha256sum rcm_1.3.0-1_all.deb | cut -f1 -d' ')
[ "$sha" = "2e95bbc23da4a0b995ec4757e0920197f4c92357214a65fedaf24274cda6806d" ] && \
sudo dpkg -i rcm_1.3.0-1_all.deb


64-bit Korora 23:

sudo dnf copr enable seeitcoming/rcm fedora-23-x86_64
sudo dnf install rcm

Korora is similar to Fedora but with an additional version and architecture specification. Replace fedora-23-x86_64 as appropriate.

OpenBSD (-current):

doas pkg_add rcm

Fedora 21/22/23:

sudo dnf copr enable seeitcoming/rcm
sudo dnf install rcm


sudo pkg install rcm

openSUSE/RHEL/CentOS: instructions

OS X with Homebrew:

brew tap thoughtbot/formulae
brew install rcm

OS X with MacPorts:

port install rcm


sudo add-apt-repository ppa:martin-frost/thoughtbot-rcm
sudo apt-get update
sudo apt-get install rcm


This uses the standard GNU autotools, so it's the normal dance:

curl -LO https://thoughtbot.github.io/rcm/dist/rcm-1.3.0.tar.gz && \

sha=$(sha256 rcm-1.3.0.tar.gz | cut -f1 -d' ') && \
[ "$sha" = "ddcf638b367b0361d8e063c29fd573dbe1712d1b83e8d5b3a868e4aa45ffc847" ] && \

tar -xvf rcm-1.3.0.tar.gz && \
cd rcm-1.3.0 && \

./configure && \
make && \
sudo make install

For more, see INSTALL.


  • rcup(1) is the main program. It is used to install and update dotfiles, with support for tags, host-specific files, and multiple source directories.
  • rcdn(1) is the opposite of rcup(1).
  • mkrc(1) is for introducing a dotfile into your dotfiles directory, with support for tags and multiple source directories.
  • lsrc(1) shows you all your dotfiles and where they would be symlinked to. It is used by rcup(1) but is provided for your own use, too.


Pull requests welcome; see CONTRIBUTING.md.


Copyright 2013 Mike Burns. BSD license. Copyright 2014-2015 thoughtbot. BSD license.

About thoughtbot


RCM is maintained and funded by thoughtbot, inc. The names and logos for thoughtbot are trademarks of thoughtbot, inc.

We adore open source software. See our other projects. We are available for hire.