Getting Started

Welcome! We are excited that you want to learn more about persistent storage for Docker Swarm. This guide provides steps for getting started with Storidge and Docker Swarm.

Storidge was built on the idea that operating storage for stateful applications should be really simple. We take a developer-centric approach for cloud native storage so you can focus on applications instead of worrying about infrastructure dependencies.

Step through this guide to see how automating storage operations greatly simplifies the way container storage and cloud native apps work together.

# Install cio

A convenience script installs the community edition of cio software into your development environments quickly and non-interactively. The use of convenience scripts is recommended for dev environments only, as root permissions are required to run them. This script will detect your Linux distribution and version, and install all dependencies and suggestions of the package manager without asking for confirmation.

Storidge's cio software currently supports CentOS 7 (3.10 kernel), RHEL 7 (3.10 kernel), Ubuntu 18.04LTS (4.15 kernel), and Ubuntu 20.04LTS (5.4 kernel).

After verifying you have a supported distribution, run the convenience script below to begin installation.

curl -fsSL | sudo bash


FTP access may not be allowed from certain countries or locations. Try using http to download and install:

curl -fsSL | sudo bash


root@demo:~# curl -fsSL | sudo bash
Started installing release 2859 at Tue Jul  9 13:05:15 PDT 2019
Loading cio software for: u16  (4.4.0-148-generic)
Reading package lists... Done
Building dependency tree
Finished at Tue Jul  9 13:08:39 PDT 2019

Installation completed. cio requires a minimum of 3 local drives per node for data redundancy.

To start a cluster, run 'cioctl create' on primary node. To add a node, generate a join token
with 'cioctl join-token' on sds node. Then run the 'cioctl node add ...' output on this node.


The installation requires access to system devices so sudo access or root user is needed

Add More Nodes

The cio software will run with just one node in the cluster. This is great if you just want to get a flavor of the capabilities of the software, and do not need high availability or advanced features like automatic data locality.

On the other hand, cio allows you to add more nodes to the cluster to increase performance, capacity and enable high availability for your applications. Repeat the convenience script installation on all nodes that will be included in the cluster. Run:

curl -fsSL | sudo bash


A multi-node configuration requires a minimum of three nodes. Currently two node configurations are not supported.

For production deployments and high availability support, a minimum of four nodes is recommended.


When working with virtual servers, it is common to clone off a base image. For multi-node clusters, verify that the ISCSI initiator name on each node is unique after cluster initialization completes.

On Linux, you can show the initiator name with: cat /etc/iscsi/initiatorname.iscsi


With software installation completed, you are ready to configure and initialize a cluster (opens new window).

Last Updated: 2/23/2021, 11:10:41 PM