yadm/_docs/020_install.md

title	permalink
Installation	/docs/install

{% include toc title="Platforms" %}

OSX

yadm can be installed using Homebrew.

brew install yadm

Fedora/Red Hat/CentOS (YUM/RPM)

Several yum repositories are on Copr. Follow this link for repositories and installation instructions.

Ubuntu

Beginning with Ubuntu 16.10 (yakkety), a version of yadm is available via standard package repositories.

---

If using an older Ubuntu release, or to get a more up-to-date version of yadm, a PPA containing yadm exists here. These commands should be sufficient to install:

sudo apt-get install -y software-properties-common
sudo add-apt-repository -y ppa:flexiondotorg/yadm
sudo apt-get update
sudo apt-get -y install yadm

---

Otherwise, the instructions for Debian below should also work for Ubuntu.

Debian

yadm is available in the stable release of Debian. It may be installed with apt-get.

Arch Linux

yadm is available in the Arch User Repos and can be installed with AUR helper or Makepkg

yaourt -S yadm-git

Gentoo Linux

yadm is available in the main gentoo portage tree, simply use emerge to install it

emerge -atv app-admin/yadm

Download

You can simply download the yadm script and put it into your $PATH. Something like this:

curl -fLo /usr/local/bin/yadm https://github.com/TheLocehiliosan/yadm/raw/master/yadm && chmod a+x /usr/local/bin/yadm

Of course, you can change the file paths above to be appropriate for your $PATH and situation.

Clone

You might wish to clone the yadm project and symlink yadm into your $PATH.

git clone https://github.com/TheLocehiliosan/yadm.git ~/.yadm-project
ln -s ~/.yadm-project/yadm ~/bin/yadm

Now you can pull the latest updates to yadm using Git. Again, adjust the file paths above to be appropriate for your $PATH and situation.

Submodule

If you are comfortable with how Git submodules work, another option is to add the yadm project as a submodule and symlink yadm into your $PATH.

cd ~
yadm submodule add https://github.com/TheLocehiliosan/yadm.git .yadm-project
yadm submodule update --init --recursive
ln -s ~/.yadm-project/yadm ~/bin/yadm
yadm add .yadm-project .gitmodules bin/yadm
yadm commit

When using submodules, you need to initialize them each time you do a fresh clone of your dotfiles.

yadm submodule update --init --recursive

Updating to a newer version of yadm would use commands similar to this.

cd ~/.yadm-project
git pull
yadm add ~/.yadm-project
yadm commit

Again, adjust the file paths above to be appropriate for your $PATH and situation.

You can find more information about Git submodules by reading the git-submodule man page.