All commands must be run under root user

Prepare system

GPU drivers


Please skip this step if want to have your node acts only as VPN gateway

It’s need to install and configure GPU drivers, supports NVIDIA and AMD cards


Prepare disk volume and filesystem


Please skip this step if want to have your node acts only as VPN gateway

Before docker installation it’s neccessary to prepare the separate disk volume for docker’s data. This volume should be mounted on /var/lib/docker and formatted in XFS filesystem.

In case if you don’t have ability to use separate disk partition, use file as separate volume:

  • create 10Gb file
fallocate -l 10G /docker-data.img
  • format it using XFS filesystem


xfsprogs package should be installed

mkfs -t xfs /docker-data.img
  • add record to /etc/fstab
/docker-data.img /var/lib/docker xfs defaults,quota,prjquota,pquota,gquota 0 0
  • mount it
mkdir /var/lib/docker
mount /var/lib/docker

Install docker-ce

curl -fsSL | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
apt-get update
apt-get install docker-ce docker-ce-cli

If you have NVIDIA GPU you need to install additional support for it:

curl -sL | apt-key add -
curl -sL$(. /etc/os-release;echo $ID$VERSION_ID)/nvidia-docker.list | tee /etc/apt/sources.list.d/nvidia-docker.list
apt-get update -qq && apt-get install -qq nvidia-container-toolkit < /dev/null > /dev/null

Restart the docker:

systemctl restart docker


It’s necessary to install wireguard software to have ability to provide VPN service:

apt install wireguard

Install OctaSpace software

  • install distribution
curl | bash

By default to access the node TCP port 47015 is used and must be open in firewall. If you need to change it, run the installation as:

curl | bash

Go to and add new node.


The following ports must be opened:

Port Protocol Description
47015 TCP Node Control Interface
51800-53000 TCP VPN service ports
51800-53000 UDP VPN service ports
27000 TCP Jupyter Lab
38000 TCP Network P2P port
38000 UDP Network discovery port

The ports above are defaults ports used by system, the ports except network ports are possible to change to another ones in the CUBE interface.

DDNS - Dynamic DNS

If you don’t have static IP address you may use dynamic DNS service to make your node available via domain name instead of IP address.

After dynamic DNS is configured you able to install node software by specifying this name like:

curl | bash