Install Go IPFS

We recommend installing IPFS from a prebuilt package. You can obtain those from dist.ipfs.io.

For convenience here are the latest versions linked directly

Installing from a Prebuilt Package

Mac OS X and Linux

After downloading, untar the archive, and move the ipfs binary somewhere in your executables $PATH:

tar xvfz go-ipfs.tar.gz
mv go-ipfs/ipfs /usr/local/bin/ipfs

Test it out:

> ipfs help
USAGE:

    ipfs - Global p2p merkle-dag filesystem.
...

Congratulations! You now have a working IPFS installation on your computer.

Getting Started with IPFS   

Windows

After downloading, unzip the archive, and move ipfs.exe somewhere in your %PATH%.

Test it out:

> ipfs help
USAGE:

    ipfs - Global p2p merkle-dag filesystem.
...

Congratulations! You now have a working IPFS installation on your computer.

Getting Started with IPFS   


Building from Source

Warning: In the past you could install IPFS using go get this does not work anymore!

If you want, you can also build IPFS from source. If you are on Mac OS X or Linux take a look at the readme for install instructions. If you are on Windows take a look at this document for instructions.


Troubleshooting

Help!

If you have any problems, come get live help at #ipfs or via the mailing list.

Check Go Version

IPFS works with Go 1.7.0 or later. To check what go version you have installed, type go version. Here's what I get:

> go version
go version go1.7 linux/amd64

If you need to update, it is recommended to install from the canonical Go packages. Package managers often contain out-of-date Go packages.

Install FUSE

For more details on setting up FUSE (so that you can mount the filesystem), see github.com/ipfs/go-ipfs/blob/master/docs/fuse.md