No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
larsks make updates work for ipns remotes
with this commit, if your remote points to an ipns name
(as in `ipfs::/ipns/HASH`), then running `git pull` will resolve the
ipns name and fetch new refs.  What this means in practice is that you
can `git push` in one location and successfully `git pull` those changes
from another location,
Latest commit 69b93f1 Sep 12, 2015
Type Name Latest commit message Commit time
Failed to load latest commit information.
git_remote_ipfs make updates work for ipns remotes Sep 12, 2015 added README and LICENSE, fixed requirements.txt Sep 12, 2015

This is a gitremote helper permitting git to clone from and push to ipfs. Note that while it works in principal, it is only mildly useful until such time as the ipfs project introduces support for publishing multiple names via ipns.


You can install this module directly using pip, like this:

pip install git+

You can of course also clone it and run instead.


Using IPFS style paths

Because paths like /ipfs/HASH look just like filesystem paths, we need to explicitly tell git to use an ipfs remote by prefixing the path with ipfs::, like this:

git clone ipfs::/ipfs/HASH myproject

The code is able to resolve ipns names, so this will also work:

git clone ipfs::/ipfs/HASH myproject

Note that ipns support is effectively useless right now, until it becomes possible to publish more than a single name per client.


This code also supports a URL format for ipfs remotes. For explicit hashes (the equivalent of /ipfs/HASH), the format is:



git clone ipfs:///HASH

For ipns names, the format is:


Yes, the difference is a single /. This will probably changed, based on the discussion in issue 1678.


Pushing to ipfs

$ git remote add ipfs ipfs::
$ git push ipfs master
WARNING:git_remote_ipfs.remote:new repository hash = QmctS8mbpdQ1rgvS9SdFfJsoAE8s97FdXDHJQtobewAXKG
To ipfs::
 * [new branch]      master -> master

Cloning from ipfs

To clone from ipfs the repository pushed in the previous example:

$ git clone ipfs::/ipfs/QmctS8mbpdQ1rgvS9SdFfJsoAE8s97FdXDHJQtobewAXKG myproject


The support for ipns references is completely untested at this point. While an initial clone from an ipns name should work, there is no code for updating the name with a new HEAD when pushing changes.


You can enable verbose debugging by setting GIT_IPFS_LOGLEVEL=DEBUG in your environment.


git-remote-ipfs -- a gitremote helper for ipfs
Copyright (C) 2015 Lars Kellogg-Stedman

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see