TFCMD Getting Started

Introduction

This section covers the basics on how to set up and use TFCMD (tfcmd).

TFCMD is available as binaries. Make sure to download the latest release and to stay up to date with new releases.

Mycelium Network

Note that you can use the Mycelium network to connect to your deployments. A Mycelium IP is assigned by default to TFCMD deployments. You can consult the different examples to understand this further.

Installation

An easy way to use TFCMD is to download and extract the TFCMD binaries to your path.

• Download latest release from releases

  • wget <binaries_url>
    

• Extract the binaries

  • tar -xvf <binaries_file>
    

• Move tfcmd to any $PATH directory:

  mv tfcmd /usr/local/bin
  

Login

Before interacting with Threefold Grid with tfcmd you should login with your mnemonics and specify the grid network:

$ tfcmd login
Please enter your mnemonics: <mnemonics>
Please enter grid network (main,test): <grid-network>

This validates your mnemonics and store your mnemonics and network to your default configuration dir. Check UserConfigDir() for your default configuration directory.

Commands

You can run the command tfcmd help at any time to access the help section. This will also display the available commands.

Using TFCMD

Once you've logged in, you can use commands to deploy workloads on the TFGrid. Read the next sections for more information on different types of workloads available with TFCMD.