Installing MatterV Host

This guide provides step-by-step instructions for installing MatterV Host. There are two installation methods available: network installation and offline installation.

Network 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-host.sh | sudo bash -

• Wait for the installation to complete. The installer will:
  • Download the latest MatterV Host package
  • Install required dependencies
  • Configure system settings
  • Start the MatterV Host service

Offline Installation

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 Host Release
  • Download the MatterV Host package (example: matterv-host-0.7.0.tar.xz)

• Transfer the package:

  • Copy the downloaded package to your MatterV Host server
  • Ensure you have sufficient permissions in the destination directory

• Install MatterV Host:

# Extract the package
tar xzf matterv-0.7.0.tar.xz

# Run the installer
bash ./installer -l matterv-0.7.0.tar.xz

Verifying the Installation

After installation is complete, verify that MatterV Host is running properly:

systemctl status matterv-host

The output should show that the service is “active (running)”. For example:

matterv-host.service - Matterv Host Service
   Loaded: loaded (/etc/systemd/system/matterv-host.service; enabled; preset: disabled)
   Active: active (running) since Sat 2024-12-07 12:41:48 PST; 9min ago
 Main PID: 13359 (java)
    Tasks: 50 (limit: 48891)
   Memory: 235.8M
      CPU: 8.067s
   CGroup: /system.slice/matterv-host.service
           └─13359 /usr/bin/java -jar /opt/matterv/host/host.jar server /opt/matterv/host/app.yaml