Deployment Automation

IPFS Cluster Dec 15, 2019

We have a number of automations to facilitate configuring and deploying IPFS Clusters:

Ansible roles

Ansible roles for configuring and deploying ipfs-cluster-service, ipfs-cluster-ctl and go-ipfs (including templated configuration files) are available at


IPFS Cluster provides official dockerized releases at along with an example template for docker-compose.

If you want to run one of the /ipfs/ipfs-cluster Docker containers, it is important to know that:

  • The container does not run go-ipfs and you should run the IPFS daemon separately, for example, using the ipfs/go-ipfs Docker container. The ipfs_connector/ipfshttp/node_multiaddress configuration value will need to be adjusted accordingly to be able to reach the IPFS API. This path supports DNS addresses (/dns4/ipfs1/tcp/5001) and is set from the CLUSTER_IPFSHTTP_NODEMULTIADDRESS environment variable when starting the container and no previous configuration exists.
  • By default, we use ┬áthe /data/ipfs-cluster as the IPFS ┬áCluster configuration path. We recommend mounting this folder as means ┬áto provide custom configurations and/or data persistency for your peers. ┬áThis is usually achieved by passing -v <your_local_path>:/data/ipfs-cluster to docker run.

The container (Dockerfile here runs an script which initializes IPFS Cluster when no configuration is present.  The configuration values can be controlled by setting environment  variables as explained in the configuration reference.

By default crdt consensus is used to initialize the configuration. This can be overriden by setting IPFS_CLUSTER_CONSENSUS=raft.

Unless you run docker with --net=host, you will need to set $CLUSTER_IPFSHTTP_NODEMULTIADDRESS or make sure the configuration has the correct node_multiaddress.

Docker compose

We also provide an example docker-compose.yml that is able to launch an IPFS Cluster with two Cluster peers and two IPFS daemons running.

One Cluster peer is launched first and acts as bootstrapper. A second  peer is bootstrapped against the first one during the first boot.  During the first launch, configurations are automatically generated and  will be persisted for next launches in the ./compose folder, along with the ipfs ones.

Only the IPFS swarm port (tcp 4001/4101) and the IPFS Cluster API ports (tcp 9094/9194) are exposed out of the containers.

This compose file is provided as an example on how to set up a multi-peer Cluster using Docker containers.

Kubernetes with Kustomize

Kustomize can be used to deploy IPFS Clusters on Kubernetes.

You can read more about it in the Running Cluster on Kubernetes guide.


Vaibhav Saini

Co-Founder TowardsBlockchain, Dappkit, SimpleAsWater | YC SUS 19 | IITD | Blockchain | AI | Speaker | Writer

Great! You've successfully subscribed.
Great! Next, complete checkout for full access.
Welcome back! You've successfully signed in.
Success! Your account is fully activated, you now have access to all content.