summaryrefslogtreecommitdiff
path: root/doc/walkthrough/using_Amazon_S3.mdwn
blob: 2833a9c5a43deebd49dd4d1fbba3bf337693f46a (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
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 a bucket, giving it a name and a description:

	git annex s3bucket mybucket unencrypted
	s3bucket (creating mybucket...) (no encryption!) ok

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

Finally, configure a git remote to use the bucket you created:

	git config remote.mys3.annex-s3-bucket mybucket

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.