Skip to main content

Quick Start Guide

Chia is a cryptocurrency and blockchain with smart transaction capabilities. Its PoST consensus is the first (and only) Nakamoto consensus since Proof of Work, and has a much lower energy consumption.

Chia's mainnet was launched on March 19, 2021. Development of its ecosystem is ongoing, with primitives recently launched for CATs, Offers, NFTs and DIDs.

The Chia software is easy to install. You can start earning cryptocurrency rewards by storing plot files on your hard drive and leaving the machine running.

Install Chia

The easiest way to install Chia is to use an installer. However, you can install from source if you want some extra control over the client.

For more detailed steps you can follow these install instructions according to your operating system. This software only supports 64 bit operating systems.



For convenience, direct links are provided to the latest installer builds. However, you should always visit to verify the checksum of the download.



Make sure you have Python 3.9 installed.

# Download chia-blockchain
git clone

# Install dependencies

# Create virtual environment
python3 -m venv venv

# Activate virtual environment
. ./venv/bin/activate

# Initialize
chia init

All configuration data is stored in a directory structure at the $CHIA_ROOT environment variable or at ~/.chia/mainnet/. You can find databases, and logs there. Optionally, you can set $CHIA_ROOT to the .chia directory in your home directory with export CHIA_ROOT=~/.chia and if you add it to your .bashrc or .zshrc it will remain set across logouts and reboots. If you set $CHIA_ROOT you will have to migrate configuration items by hand or unset the variable for chia init to work with unset CHIA_ROOT.

If you are using the MacOS or Windows builds, your keys are created during the first run. We recommend writing down the mnemonic (24 ordered words).

CLI Setup

Using the CLI with Chia gives you greater and more precise control. For a more details on the commands, read the CLI Commands Reference.

There are commands available in /Applications/

Try ./chia -h or ./chia plots -h for example. You can view your debug.log as it runs in from the terminal with tail -f ~/.chia/mainnet/log/debug.log. Additionally, you can open the file with Console application.

A handy trick is to add that directory to your path - export PATH=/Applications/$PATH. To make it persistent add the same line to your .bashrc or .zshrc inside of your user directory.

Migrate or set up configuration files

chia init

Generate keys

Create some keys by running the following script if you don't already have keys:

chia keys generate

Run a full node + farmer + harvester + wallet

To run a full node on port 8444, and connect to the mainnet, run the following command. Logs are usually at ~/.chia/mainnet/logs/debug.log or ~\.chia\mainnet\logs\debug.log on Windows


chia start farmer


cd chia-blockchain-gui
npm run electron &

Farmers are entities in the network who use their drive space to try to create blocks (like Bitcoin's miners), and earn block rewards.


Plotting is the process of creating plots to be farmed. Once a plot is created, it can be farmed indefinately. In other words, you do not have to plot forever, just plot until you are out of storage.

Reference our plotting guide for more details.

You can use the command line tools and change the working directories and output directory for plotting, with the -t (temp), -2 (second temp), and -d (destination) arguments to the chia plots create command. -n 2 will create two plots of type k=32.

chia plots create -k 32 -n 2
chia plots check -n 30


Ubuntu 20.04 LTS or newer, Amazon Linux 2, and CentOS 7.7 or newer are the easiest linux install environments.

UPnP is enabled by default to open port 8444 for incoming connections. If this causes issues, you can disable it in config.yaml. Or you can run this command: chia configure -upnp false Some routers may require port forwarding, or enabling UPnP in the router's configuration.

RPC Interface

The Node has an RPC interface. This RPC will allow you to interact with the Chia node through code.