Install & Run BTFS

BTFS daemon setup and walk-through guide

Install BTFS

Minimum Hardware Requirements

  • CPU: 2+ Core
  • RAM: 2+ GB

Supported Operating Systems and Architecture



In the terminal, run the following steps:

  1. Download the BTFS script.
  1. Run the install script.
bash -o darwin -a amd64 # For macOS x86_64
bash -o darwin -a 386 # For macOS x86
bash -o linux -a amd64 # For Linux x86_64
bash -o linux -a 386 # For Linux x86
bash -o linux -a arm64 # For Linux ARM64
bash -o linux -a arm # For Linux ARM
// Output

Installation of BTFS succeeded!
  1. Add BTFS path to the environment.
export PATH=${PATH}:${HOME}/btfs/bin
  1. Initialize BTFS by running btfs init.
btfs init

// Output

Generating TRON key with BIP39 seed phrase...
Master public key:  xpub661MyMwAqRbcGXasJpxrNnCbyd4kCfxUmrKaJXmuN5zkTU3woSeT3hnBwrPDYg6Q96MgQf43PtY7E9rHubyvcecc1NjcLKKpJAMZkM1H3Xv
initializing BTFS node at /Users/tron/.btfs
generating btfs node keypair with TRON key...done
peer identity: 16Uiu2HAkzrKxViobEK8EtQLUoxwAvBjfsV59kgqrRKuJ8VHzHcPS
to get started, enter:

	btfs cat /btfs/QmZjrLVdUpqVU6Pnc8pBnyQxVdpn9J8tfcsycP84W6N93C/readme
  1. Start the BTFS daemon by running btfs daemon.
btfs daemon

// Output

Initializing daemon...
go-btfs version: 1.0.0-
Repo version: 7
System version: amd64/darwin
Golang version: go1.13.6
Swarm listening on /ip4/
Swarm listening on /ip4/
Swarm listening on /ip6/::1/tcp/4001
Swarm listening on /p2p-circuit
Swarm announcing /ip4/
API server listening on /ip4/
Gateway (readonly) server listening on /ip4/
Remote API server listening on /ip4/
Daemon is ready
Hosts info will be synced at [SCORE] mode
BTFS is up-to-date.
  1. Once your BTFS daemon has started, open a second terminal window to run the BTFS commands.


  1. Download the Windows compressed file: amd64 386.
  2. Make sure you have permission to delete files in the btfs project directory.
  3. Initialize the BTFS path:
    a. Create a new btfs folder under the D drive.
    b. Go to the btfs folder.
    c. Copy your computer version of the btfs binary and config file to the btfs folder.
    d. Unzip the btfs binary and rename it to btfs.exe.
    e. Rename the btfs config to config.yaml.
    f. Add the btfs folder to the environment variable.
  4. Initialize BTFS
btfs.exe init
  1. Start the daemon
btfs.exe daemon


BTFS has a built-in AutoUpdate feature that will check for the latest BTFS version available and update as necessary.

Common Usage

Add a File

Add a file to your BTFS daemon by running btfs add <file name>:

btfs add heart.png

// Output

added QmdA3o9nFLwfF21GizuMK4xZpvdrZmwdA8xR8Z78Hn7J1i heart.png
 29.89 KiB / 29.89 KiB [==================================================================================] 100.00%

Get a File

Get a file by running btfs get <file hash value>:

btfs get QmdA3o9nFLwfF21GizuMK4xZpvdrZmwdA8xR8Z78Hn7J1i

// Output

Saving file(s) to QmdA3o9nFLwfF21GizuMK4xZpvdrZmwdA8xR8Z78Hn7J1i
 29.89 KiB / 29.89 KiB [===============================================================================] 100.00% 0s

Remove a File

Remove a file from your BTFS daemon by running btfs rm <file hash value>:

btfs rm QmdA3o9nFLwfF21GizuMK4xZpvdrZmwdA8xR8Z78Hn7J1i

// Output

"Removed QmdA3o9nFLwfF21GizuMK4xZpvdrZmwdA8xR8Z78Hn7J1i"


Explore the BTFS WebUI by pasting the URL in your browser: