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:

  - Windows 10 [download](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.

## autobuilds

An autobuild is also available, thanks to the Datalad project.

* Windows 10 [download](https://downloads.kitenet.net/git-annex/autobuild/windows/git-annex-installer.exe)
  ([build logs](https://github.com/datalad/git-annex/actions?query=workflow%3A%22Build+git-annex+on+Windows%22))

## download security

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

## 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, see Build/NullSoftInstaller.hs for details.)
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)`

note windows versions the builds will work with 2020-10-28 17:21:47 +00:00			`* Then, install git-annex:`

remove link to old windows 7 build that autobuilder is no longer available 2021-03-22 17:48:46 +00:00			`- Windows 10 [download](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 with autobuilder 2013-05-17 17:38:45 +00:00			`## autobuilds`
update for Windows 2013-05-13 17:46:03 +00:00
Windows build changed to one done by the datalad-extensions project using Github actions This is a cleaner build than on Jenkins because the whole environment setup is handled by the CI config, at least up to the point of "get a random bag of Windows bytes". Also, the Jenkins autobuilder has been intermittently failing for a long time, not due to any problem with git-annex but just a failure to clean up directories. Also, this build runs the test suite, and it is (mostly) passing. Test suite always failed in the jenkins environment. Also, this build includes libmagic. Here is the build workflow used by github actions: https://github.com/datalad/datalad-extensions/blob/master/.github/workflows/build-git-annex-windows.yaml The libmagic build has its own workflow: https://github.com/datalad/file-windows/blob/master/.github/workflows/build.yml (Also cleaned up some windows build cruft I don't use anymore.) There is no build-version file to link to. I've opened a todo requesting one: https://github.com/datalad/datalad-extensions/issues/55 2020-10-26 17:06:50 +00:00			`An autobuild is also available, thanks to the Datalad project.`
update 2013-05-15 00:12:13 +00:00
update autobuilds 2021-07-02 17:01:24 +00:00			`* Windows 10 [download](https://downloads.kitenet.net/git-annex/autobuild/windows/git-annex-installer.exe)`
			`([build logs](https://github.com/datalad/git-annex/actions?query=workflow%3A%22Build+git-annex+on+Windows%22))`
update 2013-05-15 00:12:13 +00:00
move a paragraph into the pages that the links it talks about were long ago moved to 2023-02-11 20:07:05 +00:00			`## download security`

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

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`
make windows installer builder include libmagic files when present, but skip otherwise 2020-10-26 17:36:43 +00:00			`installer system, see Build/NullSoftInstaller.hs for details.)`