git-annex/doc/install/Linux_standalone.mdwn

If your Linux distribution does not have git-annex packaged up for you,
you can either build it [[fromsource]], or you can use a handy
prebuilt tarball of the most recent release.

This tarball should work on most Linux systems. It has basically no
dependencies and is self-contained.

* x86-32: [download tarball](https://downloads.kitenet.net/git-annex/linux/current/git-annex-standalone-i386.tar.gz)
* x86-64: [download tarball](https://downloads.kitenet.net/git-annex/linux/current/git-annex-standalone-amd64.tar.gz)
* x86-32, for ancient kernels: [download tarball](https://downloads.kitenet.net/git-annex/linux/current/git-annex-standalone-i386-ancient.tar.gz)
* arm: [download tarball](https://downloads.kitenet.net/git-annex/linux/current/git-annex-standalone-armel.tar.gz)
* arm64: [download tarball](https://downloads.kitenet.net/git-annex/linux/current/git-annex-standalone-arm64.tar.gz)

To use, just unpack the tarball, `cd git-annex.linux` and run `./runshell`
-- this sets up an environment where you can use `git annex`, as well
as everything else included in the bundle.

Alternatively, you can unpack the tarball, and add the directory to your
`PATH`, or symlink the programs in the directory to a directory in your
PATH. This lets you use `git annex`, without overriding your system's
own versions of git, etc.

The arm version can be installed on NAS devices and other embedded ARM
linux systems.

* [[tips/Synology_NAS_and_git_annex]]
* [[forum_thread|forum/new_linux_arm_tarball_build]]

The build for ancient kernels is for use with Linux kernel versions
such as 2.6.32. It will work on both 32 and 64 bit systems.

## autobuilds

An hourly autobuild is also available, thanks to Mesar Hameed and the University
of Bath CS department.

* x86-32: [download tarball](https://downloads.kitenet.net/git-annex/autobuild/i386/git-annex-standalone-i386.tar.gz) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/i386/))
* x86-64: [download tarball](https://downloads.kitenet.net/git-annex/autobuild/amd64/git-annex-standalone-amd64.tar.gz) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/amd64/))
* x86-32, for ancient kernels: [download tarball](https://downloads.kitenet.net/git-annex/autobuild/i386-ancient/git-annex-standalone-i386-ancient.tar.gz) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/i386-ancient/))

The arm autobuilder runs daily (sun permitting), and is hosted by [[Joey]].

* arm: [download tarball](https://downloads.kitenet.net/git-annex/autobuild/armel/git-annex-standalone-armel.tar.gz) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/armel/))

The arm64 autobuilder runs only intermittently. [[Better hosting needed.|todo/arm64_autobuilder]].

* arm64: [download tarball](https://downloads.kitenet.net/git-annex/autobuild/armel/git-annex-standalone-arm64.tar.gz) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/arm64/))

## technical details

The way those tarballs are built is described in [joeyh's blog](http://joeyh.name/blog/entry/completely_linux_distribution-independent_packaging/).
building linux standalone tarballs 2012-09-28 18:21:39 -04:00			`If your Linux distribution does not have git-annex packaged up for you,`
reorg and rewrote build-from-source instructions 2014-09-16 15:05:12 -04:00			`you can either build it [[fromsource]], or you can use a handy`
linux daily builds now available 2013-02-22 18:18:28 -04:00			`prebuilt tarball of the most recent release.`
building linux standalone tarballs 2012-09-28 18:21:39 -04:00
Linux standalone build now includes its own glibc and forces the linker to use it, to remove dependence on the host glibc. 2013-12-16 01:51:19 -04:00			`This tarball should work on most Linux systems. It has basically no`
			`dependencies and is self-contained.`
simpler links to prebuilt tarballs 2012-09-28 20:56:26 -04:00
use more generic architecture names 2014-08-15 12:49:03 -04:00			`* x86-32: [download tarball](https://downloads.kitenet.net/git-annex/linux/current/git-annex-standalone-i386.tar.gz)`
			`* x86-64: [download tarball](https://downloads.kitenet.net/git-annex/linux/current/git-annex-standalone-amd64.tar.gz)`
add i386-ancient build 2015-09-23 13:36:45 -04:00			`* x86-32, for ancient kernels: [download tarball](https://downloads.kitenet.net/git-annex/linux/current/git-annex-standalone-i386-ancient.tar.gz)`
use more generic architecture names 2014-08-15 12:49:03 -04:00			`* arm: [download tarball](https://downloads.kitenet.net/git-annex/linux/current/git-annex-standalone-armel.tar.gz)`
adding arm64 build, and improved termux installation process * Added arm64 Linux standalone build. (No autobuilder yet.) * Improved termux installation process. Added git-annex-install.sh script to avoid user needing to type as much in termux. The scope of this script is limited; runshell handles the rest. Runshell runs termux-fix-shebang on the shell scripts. The problem is the bundled bin/sh script, deleting that script also works, but then the others probably use the system Android /bin/sh, which could be old or broken or not posix or whatever. Using termux sh to run the scripts is better. This commit was sponsored by Eric Drechsel on Patreon. 2018-10-11 13:22:02 -04:00			`* arm64: [download tarball](https://downloads.kitenet.net/git-annex/linux/current/git-annex-standalone-arm64.tar.gz)`
update; android tarball 2013-02-13 14:32:16 -04:00
			To use, just unpack the tarball, `cd git-annex.linux` and run `./runshell`
improve linux standalone bundle instuctions, mentioning the PATH setup option 2013-03-20 13:40:57 -04:00			-- this sets up an environment where you can use `git annex`, as well
			`as everything else included in the bundle.`

			`Alternatively, you can unpack the tarball, and add the directory to your`
Programs from Linux and OSX standalone builds can now be symlinked into a directory in PATH as an alternative installation method, and will use readlink to find where the build was unpacked. 2013-12-15 15:57:41 -04:00			`PATH`, or symlink the programs in the directory to a directory in your
			PATH. This lets you use `git annex`, without overriding your system's
improve linux standalone bundle instuctions, mentioning the PATH setup option 2013-03-20 13:40:57 -04:00			`own versions of git, etc.`
update; android tarball 2013-02-13 14:32:16 -04:00
use more generic architecture names 2014-08-15 12:49:03 -04:00			`The arm version can be installed on NAS devices and other embedded ARM`
add section linking to specific NAS howtos 2014-01-02 13:35:40 -04:00			`linux systems.`

			`* [[tips/Synology_NAS_and_git_annex]]`
			`* [[forum_thread\|forum/new_linux_arm_tarball_build]]`
linux daily builds now available 2013-02-22 18:18:28 -04:00
add i386-ancient build 2015-09-23 13:36:45 -04:00			`The build for ancient kernels is for use with Linux kernel versions`
i386ancient build switched to stack, has more flags enabled 2016-03-05 17:16:46 -04:00			`such as 2.6.32. It will work on both 32 and 64 bit systems.`
add i386-ancient build 2015-09-23 13:36:45 -04:00
linux daily builds now available 2013-02-22 18:18:28 -04:00			`## autobuilds`

update 2015-06-01 13:50:18 -04:00			`An hourly autobuild is also available, thanks to Mesar Hameed and the University`
credit for new autobuilder 2013-09-11 11:41:48 -04:00			`of Bath CS department.`
linux daily builds now available 2013-02-22 18:18:28 -04:00
use more generic architecture names 2014-08-15 12:49:03 -04:00			`* x86-32: [download tarball](https://downloads.kitenet.net/git-annex/autobuild/i386/git-annex-standalone-i386.tar.gz) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/i386/))`
			`* x86-64: [download tarball](https://downloads.kitenet.net/git-annex/autobuild/amd64/git-annex-standalone-amd64.tar.gz) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/amd64/))`
add i386-ancient build 2015-09-23 13:36:45 -04:00			`* x86-32, for ancient kernels: [download tarball](https://downloads.kitenet.net/git-annex/autobuild/i386-ancient/git-annex-standalone-i386-ancient.tar.gz) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/i386-ancient/))`
update 2015-06-01 13:50:18 -04:00
arm autobuilder moved to my house 2017-07-26 10:31:52 -04:00			`The arm autobuilder runs daily (sun permitting), and is hosted by [[Joey]].`
update 2015-06-01 13:50:18 -04:00
use more generic architecture names 2014-08-15 12:49:03 -04:00			`* arm: [download tarball](https://downloads.kitenet.net/git-annex/autobuild/armel/git-annex-standalone-armel.tar.gz) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/armel/))`
link to the technical description of how this works 2015-02-24 22:00:26 +00:00
update 2018-10-11 13:50:22 -04:00			`The arm64 autobuilder runs only intermittently. [[Better hosting needed.\|todo/arm64_autobuilder]].`

			`* arm64: [download tarball](https://downloads.kitenet.net/git-annex/autobuild/armel/git-annex-standalone-arm64.tar.gz) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/arm64/))`

link to the technical description of how this works 2015-02-24 22:00:26 +00:00			`## technical details`

			`The way those tarballs are built is described in [joeyh's blog](http://joeyh.name/blog/entry/completely_linux_distribution-independent_packaging/).`