Install Using Docker


Maintenance on-hold

Currently this type of installation is not maintained; Proceed at your own risk. Note: Several users, including Blockpane, utilize docker for a FIO install.


fio-wallet users

If you use fio-wallet (keosd) to manage FIO keys, you should use 'Manual Installation' to set up your node.


These images always use the latest published builds

It might include release-candidates, check the FIO Github to see what this will be downloading

These are simple docker-compose configs for bringing up a FIO node. There are two configs for each network
(mainnet and testnet). The v1history will start a light-history node, it's highly recommended to use this
image if not using a state-history or hyperion node, the extra overhead is minimal (this is not the EOSIO
v1 history plugin, it is the Greymass light history implementation, only requiring about 200mb with an 8gb

These images pull a full archive of the blocks, and a snapshot if using the standard node. The history image
pulls a complete archive, including the state database, history files, and blocks. This download takes a long
time, expect 30 minutes or more, but is much faster than waiting for a node to sync from genesis (a day or more).


The API is exposed on 8888, and P2P is on 3856 for all images

Edit the docker-compose if your needs differ.


Each container will store the chain data in a volume, allowing for easy upgrades without data loss.


Install docker (ubuntu)

echo "Remove any old docker packages..."
sudo apt-get -y remove docker docker-engine containerd runc
echo "Update apt package index..."
sudo apt-get update
echo "Updating ubuntu repos..."
sudo apt-get -y install ca-certificates curl gnupg lsb-release
echo "Add Docker’s official GPG key..."
sudo mkdir -p /etc/apt/keyrings
curl -fsSL | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "Set up the Docker repository..."
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg]\ $(lsb_release -cs) stable"\
 | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
echo "Install docker and jq..."
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli docker-compose-plugin
sudo usermod -a -G docker $(whoami)
newgrp -

Clone the fio-docker repository

git clone

Start a node

cd fio-docker/testnet-v1history
docker-compose up -d

This will perform the following actions:

  1. Download and install the latest FIO packaged deb file (e.g.,
  2. Fetch the latest blocks.log archive (this can take 30+ minutes)
  3. Start nodeos on port 8888 (if you use the default port)

Confirm your node is running

curl --url http://localhost:8888/v1/chain/get_info

Sync status will show in the Docker logs

cd fio-docker/testnet-v1history
docker-compose logs -f --tail 20

List your running Docker containers

docker ps

CONTAINER ID   IMAGE            COMMAND                  CREATED          STATUS          PORTS                                                                                  NAMES
4756dc0abf5e   testnet_nodeos   "/usr/local/bin/fio-…"   22 minutes ago   Up 22 minutes>3856/tcp, :::3856->3856/tcp,>8888/tcp, :::8888->8888/tcp   testnet_nodeos_1

Access Docker container to run commands

docker exec -it testnet_nodeos_1 /bin/bash

Upgrade an existing node

docker-compose --no-cache build
docker-compose up -d

Destroy a node

docker-compose down -v


Thanks to blockpane for the original version of these scripts.