git-annex/doc/install/Windows.mdwn

git-annex now does Windows!

* First, [install Git for Windows](http://git-scm.com/downloads)

* Then, [install git-annex](https://downloads.kitenet.net/git-annex/windows/current/)

This port is now in reasonably good shape for command-line use of
git-annex. The assistant and webapp are also usable. There are some known
problems and parts that don't work. See [[todo/windows_support]] for
current status.

To verify that the build of git-annex works in your Windows system, you are
encouraged to run the test suite before using git-annex on real data. After
installation, run `git annex test`. There will be a lot of output; the
important thing is that it should end with "All tests passed".

## autobuilds

An hourly autobuild is also available, thanks to Yury V. Zaytsev and
Dartmouth College.

* [download](https://downloads.kitenet.net/git-annex/autobuild/windows/)

## building it yourself

To build git-annex from source on Windows, you need to install
[Git for Windows](http://git-scm.com/downloads), and
[Stack](http://haskellstack.org/).

Then open Git Bash, [[clone git-annex|download]], and in git-annex's source
tree, run "stack build" to download and
build all dependencies and git-annex. "stack install" will install git-annex.

(To build the git-annex installer, you also need to install the NullSoft
installer system. The script `standalone/windows/build.sh` is
used to make the builds linked to above.)
update 2014-02-04 19:13:25 +00:00			`git-annex now does Windows!`
update for Windows 2013-05-13 17:46:03 +00:00
tighten added language Removed part about neeing to install git-annex and git in the same location. The installer checks if the location given exists, and if not, tells the user that git is not installed there. And the default should work if the user just picks it in both installers. 2016-11-29 17:37:16 +00:00			`* First, [install Git for Windows](http://git-scm.com/downloads)`

downloads.kitenet.net now supports https; use it for all links 2013-06-26 23:21:19 +00:00			`* Then, [install git-annex](https://downloads.kitenet.net/git-annex/windows/current/)`
update 2013-05-15 00:12:13 +00:00
update 2014-02-04 19:13:25 +00:00			`This port is now in reasonably good shape for command-line use of`
update 2014-06-17 18:34:51 +00:00			`git-annex. The assistant and webapp are also usable. There are some known`
			`problems and parts that don't work. See [[todo/windows_support]] for`
			`current status.`
update 2013-05-15 00:12:13 +00:00
update; windows autobuilder runs tests now 2014-12-30 21:05:35 +00:00			`To verify that the build of git-annex works in your Windows system, you are`
			`encouraged to run the test suite before using git-annex on real data. After`
			installation, run `git annex test`. There will be a lot of output; the
			`important thing is that it should end with "All tests passed".`
Improve test suite on Windows; now tests git annex sync. 2013-07-30 20:57:17 +00:00
update with autobuilder 2013-05-17 17:38:45 +00:00			`## autobuilds`
update for Windows 2013-05-13 17:46:03 +00:00
better describe autobuild 2017-10-26 17:47:47 +00:00			`An hourly autobuild is also available, thanks to Yury V. Zaytsev and`
Windows autobuilder is going to be hosted at Dartmouth now 2016-11-29 16:05:37 +00:00			`Dartmouth College.`
update 2013-05-15 00:12:13 +00:00
Remove obsolete link to Windows build logs 2016-11-30 18:37:32 +00:00			`* [download](https://downloads.kitenet.net/git-annex/autobuild/windows/)`
update 2013-05-15 00:12:13 +00:00
update with autobuilder 2013-05-17 17:38:45 +00:00			`## building it yourself`

			`To build git-annex from source on Windows, you need to install`
new simpler windows build environment using stack and git for windows and no cygwin 2016-05-05 19:47:01 +00:00			`[Git for Windows](http://git-scm.com/downloads), and`
			`[Stack](http://haskellstack.org/).`
update 2013-12-09 19:57:41 +00:00
build for windows with forked win32 package that has terminateProcessId Get ugly reversion out of CHANGELOG. Also, relocated the windows stack.yaml to top, and updated windows build instructions. This commit was sponsored by Henrik Riomar on Patreon. 2017-10-25 18:45:23 +00:00			`Then open Git Bash, [[clone git-annex\|download]], and in git-annex's source`
update stack.yaml to latest lts and remove stack-windows.yaml The latter should not be needed as this lts version includes Win32. 2019-07-09 14:33:21 +00:00			`tree, run "stack build" to download and`
			`build all dependencies and git-annex. "stack install" will install git-annex.`
update 2013-12-09 19:57:41 +00:00
update licenses file for nsis and NullSoft licences used by windows installer 2014-12-03 18:54:52 +00:00			`(To build the git-annex installer, you also need to install the NullSoft`
new simpler windows build environment using stack and git for windows and no cygwin 2016-05-05 19:47:01 +00:00			installer system. The script `standalone/windows/build.sh` is
			`used to make the builds linked to above.)`