Installing MatterV Cluster
This guide provides step-by-step instructions for installing MatterV Cluster. There are two installation methods available: network installation and offline installation.
Network Installation (Recommended)
The network installation method is the simplest way to install MatterV Host. It automatically downloads and installs the latest version.
- Run the installation command:
curl -fsSL https://github.com/matterv/matterv/releases/download/v0.7.0/install-matterv-cluster.sh | sudo bash -
- Wait for the installation to complete. The installer will:
- Download the latest MatterV Cluster package
- Install required dependencies
- Configure system settings
- Start the MatterV Cluster service
Offline Installation
Use this method when the server doesn’t have internet access or when you need to install a specific version.
-
Download the installation package:
- On a machine with internet access, visit: MatterV Cluster Release
- Download the MatterV Cluster package (example: matterv-cluster-0.7.0.tar.xz)
-
Transfer the package:
- Copy the downloaded package to your MatterV Cluster server
- Ensure you have sufficient permissions in the destination directory
-
Install MatterV Cluster:
# Extract the packagetar xzf matterv-cluster-0.7.0.tar.xz
# Run the installerbash ./installer -l matterv-cluster-0.7.0.tar.xz
Verifying the Installation
After installation is complete, verify that MatterV Cluster is running properly:
systemctl status matterv-cluster
The output should show that the service is “active (running)”. For example:
matterv-cluster.service - Matterv Cluster Service Loaded: loaded (/etc/systemd/system/matterv-cluster.service; enabled; preset: disabled) Active: active (running) since Sat 2024-12-07 12:47:13 PST; 11s ago Main PID: 13583 (java) Tasks: 48 (limit: 48891) Memory: 197.6M CPU: 6.848s CGroup: /system.slice/matterv-cluster.service └─13583 /usr/bin/java -jar /opt/matterv/cluster/cluster.jar server /opt/matterv/cluster/app.yaml