IPNS

IPNS stands for the The Inter-Planetary Naming System. ipns is a way to add a small amount of mutability to the permanent immutability that is ipfs. It allows you to store a reference to an ipfs hash under the namespace of your peerID ( hash of your public key ). - github

The commands to set it up are quite simple. First, you'll need some content to publish:

note the hash that was output, and publish that hash out to the network:

Now, to test that it worked, you could try a couple of different things:

If you ran that on the same machine, it should return instantly, as you have cached the entry locally; give it a shot on another computer running ipfs.

Another thing to try is viewing it on a gateway:

So, now comes the fun part: Lets change things.

Next, take the hash from there and...

Now, if you resolve that entry again, you'll see your new object.

There are a few things to note; first, right now, you can only publish a single entry per ipfs node. This will change fairly soon. Second, updating an ipns entry can "break links" because anything referencing an ipns entry might no longer point to the content it expected.