git-annex/doc/install.mdwn

## Pick your OS

[[!table format=dsv header=yes data="""
detailed instructions             | quick install
[[Linux|linux_standalone]]        | 
&nbsp;&nbsp;[[Debian]]            | `apt-get install git-annex`
&nbsp;&nbsp;[[Ubuntu]]            | `apt-get install git-annex`
&nbsp;&nbsp;[[Fedora]]            | `yum install git-annex`
&nbsp;&nbsp;[[ArchLinux]]         | `pacman -S git-annex`
&nbsp;&nbsp;[[NixOS]]             | `nix-env -i git-annex`
&nbsp;&nbsp;[[Gentoo]]            | `emerge git-annex`
&nbsp;&nbsp;[[Guix]]              | `guix package -i git-annex`
&nbsp;&nbsp;[[Void]]              | `xbps-install git-annex`
&nbsp;&nbsp;[[ScientificLinux]]   |
&nbsp;&nbsp;[[RHEL]]              |
&nbsp;&nbsp;[[openSUSE]]          | `zypper in git-annex`
&nbsp;&nbsp;[[Docker]]            | 
&nbsp;&nbsp;[[conda]]             | `conda install -c conda-forge git-annex`
[[OSX]]                           |
&nbsp;&nbsp;[[OSX/Homebrew]]      | `brew install git-annex`
[[FreeBSD]]                       | `pkg install hs-git-annex`
[[OpenBSD]]                       | `pkg_add git-annex`
[[Android]]                       | **beta**
[[Windows]]                       | **beta**
"""]]

All the download links above use https for security. For added security, see
[[verifying_downloads]].

## Historical builds

Many of historical builds available from the [https://downloads.kitenet.net/.git/](https://downloads.kitenet.net/.git/) git-annex repository.  Visit [downloads.kitenet.net](https://downloads.kitenet.net/) for more information.

## Building it yourself

git-annex is [[Free Software|license]], written in [Haskell](http://www.haskell.org/).
Experienced users should not find it too hard to build and install
it [[from source|fromsource]].

## See also

 * [[autobuild overview|builds]]
 * [[upgrades]]
misc 2012-09-27 21:26:09 +00:00			`## Pick your OS`
more install notes 2011-02-09 04:25:22 +00:00
update install instructions for Fedora now available in Fedora 2012-10-12 18:07:53 +00:00			`[[!table format=dsv header=yes data="""`
update 2013-05-16 16:09:13 +00:00			`detailed instructions \| quick install`
remove links to trees of files, as they confuse users and prevent them reading the instructions before downloading 2017-08-28 17:05:03 +00:00			`[[Linux\|linux_standalone]] \|`
update 2013-05-16 16:09:13 +00:00			[[Debian]] \| `apt-get install git-annex`
			[[Ubuntu]] \| `apt-get install git-annex`
			[[Fedora]] \| `yum install git-annex`
Replace Arch installation instructions with the package in official repos 2016-01-16 11:33:06 +00:00			[[ArchLinux]] \| `pacman -S git-annex`
update 2013-05-16 16:09:13 +00:00			[[NixOS]] \| `nix-env -i git-annex`
			[[Gentoo]] \| `emerge git-annex`
Add Guix to the installation instructions, as there is now package available! 2018-06-01 14:38:16 +00:00			[[Guix]] \| `guix package -i git-annex`
upgraded ilya shlyakhter's comment to install/conda page 2018-03-27 21:42:39 +00:00			[[Void]] \| `xbps-install git-annex`
rename page 2019-09-01 16:25:46 +00:00			`  [[ScientificLinux]] \|`
docs for git-annex-standalone rpm 2019-09-13 16:18:36 +00:00			`  [[RHEL]] \|`
move tumbleweed stuff to the openSUSE main page 2016-07-05 15:50:01 +00:00			[[openSUSE]] \| `zypper in git-annex`
add docker autobuilder container instructions, using propellor 2014-04-02 22:40:26 +00:00			`  [[Docker]] \|`
upgraded ilya shlyakhter's comment to install/conda page 2018-03-27 21:42:39 +00:00			[[conda]] \| `conda install -c conda-forge git-annex`
reorder it seems to make sense to have linux and osx first since a lot of users use those, and windows at the end because well, it's windows. but it seemed odd to start with osx, so moved linux up. alphabetical would maybe be better, but then android comes first, which just feels weird since it's such a niche port. also the linux distro sublist has a good reason not to be alphabetical, eg docker and conda are on there as kind of last resorts 2021-03-22 18:30:23 +00:00			`[[OSX]] \|`
			[[OSX/Homebrew]] \| `brew install git-annex`
freebsd is not a linux distribution 2021-03-22 18:28:03 +00:00			[[FreeBSD]] \| `pkg install hs-git-annex`
git-annex is in openbsd ports 2021-03-22 18:37:06 +00:00			[[OpenBSD]] \| `pkg_add git-annex`
reorder it seems to make sense to have linux and osx first since a lot of users use those, and windows at the end because well, it's windows. but it seemed odd to start with osx, so moved linux up. alphabetical would maybe be better, but then android comes first, which just feels weird since it's such a niche port. also the linux distro sublist has a good reason not to be alphabetical, eg docker and conda are on there as kind of last resorts 2021-03-22 18:30:23 +00:00			`[[Android]] \| beta`
remove links to trees of files, as they confuse users and prevent them reading the instructions before downloading 2017-08-28 17:05:03 +00:00			`[[Windows]] \| beta`
try a table 2012-09-27 21:25:08 +00:00			`"""]]`
more install notes 2011-02-09 04:25:22 +00:00
be more precise 2014-10-24 18:05:29 +00:00			`All the download links above use https for security. For added security, see`
more complete gpg key verification process, including statement signed with my personal key 2014-08-12 20:17:30 +00:00			`[[verifying_downloads]].`
added gpg instructions 2014-07-24 00:48:33 +00:00
added a note about historical builds 2020-03-09 16:50:13 +00:00			`## Historical builds`

			`Many of historical builds available from the [https://downloads.kitenet.net/.git/](https://downloads.kitenet.net/.git/) git-annex repository. Visit [downloads.kitenet.net](https://downloads.kitenet.net/) for more information.`

reorg and rewrote build-from-source instructions 2014-09-16 19:05:12 +00:00			`## Building it yourself`
reorder 2011-07-02 21:29:20 +00:00
reorg and rewrote build-from-source instructions 2014-09-16 19:05:12 +00:00			`git-annex is [[Free Software\|license]], written in [Haskell](http://www.haskell.org/).`
			`Experienced users should not find it too hard to build and install`
			`it [[from source\|fromsource]].`
add build page 2013-09-14 03:12:44 +00:00
			`## See also`

link to the upgrades page 2015-06-03 14:26:44 +00:00			`* [[autobuild overview\|builds]]`
			`* [[upgrades]]`