aboutsummaryrefslogtreecommitdiff
path: root/doc/install/Windows.mdwn
blob: 00ef702d4d8105df1177009ff88f4b001eef576b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
git-annex now does Windows!

* First, [install Git for Windows](http://git-scm.com/downloads)  
  Important: **Get the 32 bit version not the 64 bit version.**  
  (Note that msysgit is no longer supported.) If you installed the
  64 bit version of git, then parts of git-annex will still run,
  however, some features, including tools like rsync, are not-functional.
* Then, [install git-annex](https://downloads.kitenet.net/git-annex/windows/current/)
  into the same location Git has been installed to. You must provide this path to the
  git-annex installer. For instance, the path may be "C:\Users\John\AppData\Local\Programs\Git\"

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

A daily build is also available, thanks to Yury V. Zaytsev and
[NEST](http://nest-initiative.org/).

* [download](https://downloads.kitenet.net/git-annex/autobuild/windows/) ([build logs](https://qa.nest-initiative.org/view/msysGit/job/msysgit-git-annex-assistant-test/))

## 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/).

You also need to install rsync and wget for windows.
They need to be linked with the same MINGW32 libraries that come with Git
for Windows. One way is to download them from
<https://downloads.kitenet.net/git-annex/windows/assets/>.
Put them somewhere in PATH.

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.)