OctaSpace
Search…
Installation
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

Docker

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
  • edit file /etc/fstab and add the following line to the end
/docker-data.img /var/lib/docker xfs defaults,quota,prjquota,pquota,gquota 0 0
  • mount /var/lib/docker
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" | tee /etc/apt/sources.list.d/docker.list > /dev/null
apt-get update
apt-get install -y docker-ce docker-ce-cli containerd.io
If you have NVIDIA GPU you need to install additional support for it:
Restart the docker:
systemctl restart docker

Wireguard

It’s necessary to install wireguard software to have ability to provide VPN service:
apt-get install -y 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.

Open ports using UFW

The default firewall configuration tool for Ubuntu is ufw. To open ports which necessary to node operate run the following commands:
ufw allow 47015
ufw allow 51800:53000/tcp
ufw allow 51800:53000/udp
ufw allow 27000
ufw allow 38000/tcp
ufw allow 38000/udp

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
Copy link
On this page
Prepare system
GPU drivers
Docker
Wireguard
Install OctaSpace software
Firewall
Open ports using UFW
DDNS - Dynamic DNS