Installation - (New Cube)
This guide is intended to provide detailed instructions on the process of setting up nodes in the new OctaSpace Cube system.
OctaSpace nodes can range from a Raspberry Pi to CPU-only nodes to multi-GPU machines, each of which can be used for different types of services.
Please check the minimum system requirements based on the service you wish to support in the hardware requirements section under Nodes.
OctaSpace node software runs on Linux distributions and supports both x86 and ARM64 architectures.
You can find the list of supported OS under Nodes.
Before proceeding further, please ensure that you have set up one of the supported operating systems.
In cases where NVIDIA GPUs are used, you must ensure that driver version 550 is installed.
Additionally, you must install the libnvidia-gl-550-server package. It is crucial that the NVIDIA driver and the libnvidia-gl-550-server package have the same minor version.
For example, if the driver version is 550.127.05, the libnvidia-gl-550-server package must also have the same version.
Service ports are primarily used for facilitating the VPN service and providing direct access to services via a web interface that runs on nodes.
In cases where service ports are not configured, all traffic between the node and the end user is, by default, directed through dedicated proxy servers located in the geographical regions closest to the node location.
Configuration of service ports is an optional process ONLY IF NOT providing a VPN service.
Configuring service ports offers benefits such as improved network speeds between the node and the end user, and provides more direct access to the node, resulting in enhanced service quality.
If you do not intend to support VPN or prefer that services be routed through a proxy, you may proceed directly to the installation step.
For service ports to function, a node must have a static public IP address.
Depending on your network configuration, if the node is behind a NAT, you will need to configure port forwarding for a range of service ports on the router. Additionally, if the server has a firewall with a DROP policy for all incoming traffic, you will need to allow traffic to the service ports.
By default, the service port range is 51800–51816. Ensure that these ports are forwarded or opened for both TCP and UDP protocols.
All commands must be run under root user
If you intend for your node to provide RENTAL or RENDER services, ensure that the latest GPU drivers are installed. For NVIDIA cards, install version 550 or newer, if available.
Every service node need to have disk storage configured. The storage requirements can vary depending on the services that are run on the node, therefore it's important to ensure ample storage is configured.
In the case of RENTAL or RENDER services the node should have at least 200GB of disk space allocated. For VPN exit nodes 10GB is sufficient.
The disk space will be used for various purposes including, docker images, container data as well as support OctaStorage service. Providing ample storage will ensure improved support of services.
Storage partition should be formatted in XFS filesystem and mounted on /var/lib/docker directory.
Depending on the machine configuration, the number of physical disks, and the presence of a RAID controller, there are multiple ways to configure storage for a service node. Below, we outline several common examples.
Prior to proceeding further, ensure you have installed xfsprogs package:
This method is useful for when a node does not have non allocated disk partitions. We will create file on existing filesystem and mount as partition. In this example we assume that root filesystem (/) has enough free disk space and will use it to store our file based partition.
- Create a 200Gb file that will be used for storage. If you have more spare disk space, set the amount as much as possible.
- Format it in XFS filesystem
- Mount and make it mounted on system start
Install distribution:
At the end of the installation, you will be given a unique node token. Use this token to register new node on https://cube.octa.computer
