summaryrefslogtreecommitdiff
path: root/doc/walkthrough/using_Amazon_S3.mdwn
blob: 38a6a6de59c7d6ee37704b61ce075339e74cb0a2 (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
git-annex extends git's usual remotes with some [[special_remotes]], that
are not git repositories. This way you can set up a remote using say,
Amazon S3, and use git-annex to transfer files into the cloud.

First, export your S3 credentials:

	export ANNEX_S3_ACCESS_KEY_ID="08TJMT99S3511WOZEP91"
	export ANNEX_S3_SECRET_ACCESS_KEY="s3kr1t"

Next, create the remote.

	git annex initremote s3 mys3 encryption=none
	initremote (creating bucket mys3-291d2fdc-5990-11e0-909a-002170d25c55...) ok

**Note that encrypted buckets are not (yet) supported. Data sent to S3
is without encryption susceptible to snooping.**

Now the remote can be used like any other remote.

	# git annex copy my_cool_big_file --to mys3
	copy my_cool_big_file (to mys3...) ok
	# git annex move video/hackity_hack_and_kaxxt.mov --to mys3
	move video/hackity_hack_and_kaxxt.mov (to mys3...) ok

See [[special_remotes/Amazon_S3]] for details.