Installation

Tip

All commands must be run under root user

Prepare system

GPU drivers

Note

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

Docker

Prepare disk volume and filesystem

Note

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

Note

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 https://download.docker.com/linux/ubuntu/gpg | 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] https://download.docker.com/linux/ubuntu \
  $(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 containerd.io

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

curl -sL https://nvidia.github.io/nvidia-docker/gpgkey | apt-key add -
curl -sL https://nvidia.github.io/nvidia-docker/$(. /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

Wireguard

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

apt install wireguard

Install OctaSpace software

  • install distribution
curl https://install.octa.space | 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:

export ORC_PORT=SOME_OTHER_PORT
curl https://install.octa.space | bash

Go to https://cube.octa.space and add new node.

Firewall

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:

export ORC_DOMAIN_NAME=yournode.domain.com
curl https://install.octa.space | bash
Next