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

• Mac OS X 32bit
• Mac OS X 64bit
• Linux 32bit
• Linux 64bit
• Windows 32bit
• Windows 64bit
• FreeBSD 64bit

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

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.5.2+. To check what go version you have installed, type go version. Here's what I get:

> go version
go version go1.5.2 darwin/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