This special remote allows downloading annexed objects from other special remotes that also publish their content by http. Not to be confused with the web special remote, or with accessing git-annex repositories over http, this is only useful in combination with some other special remote.

Suppose, for example, that you have a directory special remote. And the directory happens to be published by a web server. (Or it could be a rsync special remote, or many other kinds.) To let git-annex know that the content of this special remote can also be accessed over http, set up a httpalso special remote.

git annex initremote --sameas=foo foo-http type=httpalso url=http://example.com/foo

The --sameas parameter tells git-annex what other special remote this httpalso remote is accessing. (See multiple remotes accessing the same data store.) Since the httpalso remote is read-only, it can only be used to download content that is stored in that other remote.

This special remote is compatible with many, but not all, other special remotes. If the special remote does something unusual with the name a file is stored under, or with how the data is stored, it might not work. See multiple remotes accessing the same data store for a list of known working combinations.

configuration

  • url - The http or https url to where the content is stored by the other special remote.
  • exporttree - If the other special remote has exporttree=yes set, it also needs to be set when initializing the httpalso remote. Setting this does not allow trees to be exported to the httpalso remote, because it's read-only. But it does let exported files be downloaded from it.
  • annexobjects - If the other special remote has annexobjects=yes set (along with exporttree=yes), it also needs to be set when initializing the httpalso remote.

Configuration of encryption and chunking is inherited from the other special remote, and does not need to be specified when initializing the httpalso remote.