Skip to content

Getting Started

ZenGround0 edited this page Mar 22, 2019 · 65 revisions

This is a step-by-step guide for installing and running a Filecoin node connected to the User Devnet on your computer. Subsequent tutorials explain how to mine Filecoin or store data with your node.

Table of Contents

Install Filecoin (and its dependencies)

Installing from binary

  • Go to the go-filecoin Releases page on GitHub.
  • Click on the green "Latest release" below the "Tags" button
  • Click on the .tar.gz link that matches your operating system (OSX or Linux)
  • Unzip the downloaded file
  • Fire up your terminal ( on MacOS)
  • Create a directory for proofs parameters and fetch them via paramfetch
    mkdir -p /tmp/filecoin-proof-parameters
    ./paramfetch -a
    # be warned, this can take a long time
  • Add go-filecoin to your path by opening the filecoin folder inside your Terminal and running:
    export PATH="$(pwd)":$PATH
  • You will need to add the previous line to your shell init file like ~/.bash_profile (advanced) or run it from the filecoin directory in each terminal you open.

Installing from source

Use these steps to install filecoin:

  1. Ensure you have the correct code for joining the user devnet. (Note: these will be tags or branches in the future)

    cd $GOPATH/src/
    git fetch origin devnet-user -f
    git checkout devnet-user
  2. Install paramfetch

  3. Install proof parameters in /tmp/filecoin-proof-parameters

    mkdir -p /tmp/filecoin-proof-parameters/
    pushd proofs/rust-fil-proofs
    ../bin/paramfetch -a
  4. Install dependencies

    FILECOIN_USE_PRECOMPILED_RUST_PROOFS=true go run ./build deps
  5. Build the project and install it

    go run ./build build
    go run ./build install

Start running Filecoin

  1. If you have run go-filecoin before, remove existing Filecoin initialization data:

    rm -rf ~/.filecoin
  2. Initialize go-filecoin. The --devnet-user flag connects you to our main devnet.

    go-filecoin init --devnet-user --genesisfile=
  3. Start your go-filecoin daemon.

    go-filecoin daemon

    This should return "My peer ID is <peerID>", where <peerID> is a long CID string starting with "Qm".

    Note: this can be slow the first time. The filecoin node needs a large parameter file for proofs, stored in /tmp/filecoin-proof-parameters. It's usually generated by the deps build step. If these files are missing they will be regenerated, which can take up to an hour. We are working on a better solution.

    Note: if you're a developer and wish to connect to the nightly devnet rather than user devnet, you must configure your node to use small sectors, and build from the devnet-nightly tag.

    env FIL_USE_SMALL_SECTORS=true go-filecoin daemon
  4. Check your connectivity

    go-filecoin swarm peers                  # lists addresses of peers to which you're connected

    The last segment of a peer's address is it's peerID. Test your connection directly to a peer with

    go-filecoin ping <peerID>                # Pings the peer and displays round-trip latency.

🎉 Woohoo! You are now running a Filecoin node and connected to the network. This is the anatomy of a basic node (plus a miner, which you'll create in the next step, Mining Filecoin):

Note: The daemon is now running indefinitely in its own Terminal (Ctrl + C to quit). To run other go-filecoin commands, you'll need to open a second Terminal tab or window (Cmd + T on Mac).

It may take several minutes for your node to sync and validate the existing blockchain, during which you'll observe intense activity on one CPU core.

Need help? See Troubleshooting & FAQ or #fil-dev on Matrix chat.

Name your Filecoin node

By default, nodes are referenced by long, alphanumeric node IDs. You can give your node a human-readable nickname.

  • Nicknames can only contain letter characters (no numbers, spaces, or other special characters).
  1. Open a new Terminal window and set your node nickname (replace Pizzanode with the name of your choice):
    go-filecoin config heartbeat.nickname "Pizzanode"
  2. The new name takes effect immediately, no need to restart. You can check the configured name with:
    go-filecoin config heartbeat.nickname

Start streaming activity from your node

We have a few visualization tools to understand what's happening on the Filecoin network: the Network Stats and block explorer.

To see your node on the network stats, you'll need to opt in to streaming your node's logs. Open a new Terminal window and run:

go-filecoin config heartbeat.beatTarget "/dns4/"

Restart the currently running go-filecoin daemon process and then go to the Network Stats and watch your node reach consensus with the rest of the network.

Get FIL from the Filecoin faucet

Before Filecoin nodes can participate in the marketplace, they will need some start-up filecoin tokens (FIL). Clients need FIL in their accounts to make storage deals with miners. Miners use FIL for collateral when initially pledging storage to the network.

During early testing, you can obtain mock FIL from the Filecoin faucet. The "faucet" is thusly named because it drips (or pours) FIL into those who stick their wallets under it. Using mock FIL allows for preliminary testing of market dynamics without the requirement for any money to actually change hands.

All balances of FIL are stored in wallets. When a node is newly created, it will have a Filecoin wallet with a balance of 0 FIL.

  1. Let's get you some FIL. Get your wallet address:

    go-filecoin wallet addrs ls
  2. The output should be a long alphanumeric string. Go to the User Devnet faucet at and submit that wallet address. It will take a minute for the FIL to land in your wallet.

    1. Alternatively, you can tap the faucet from the command line:
      export WALLET_ADDR=`go-filecoin wallet addrs ls`    # fetch your wallet address into a handy variable
      MESSAGE_CID=`curl -X POST -F "target=${WALLET_ADDR}" "" | cut -d" " -f4`
  3. The faucet will provide you with a message CID. The message should be processed in about 30 seconds. You can run the following command to wait for confirmation:

    go-filecoin message wait ${MESSAGE_CID}
  4. To verify that the FIL has landed in your wallet, check your wallet balance:

    go-filecoin wallet balance ${WALLET_ADDR}

🎉 Congrats, you're now connected to Filecoin AND can begin mining or storing data on the Filecoin network! Next, choose your adventure:

You can’t perform that action at this time.