Solusvm2
SolusVM Documentation

Installation and Logging In

Overview

This topic explains how to install the SolusVM Management Node. The Management Node lets you manage your cluster through the Administrator and Client web interfaces and via the REST API.

Installation Requirements

You can install the Management Node on a physical or virtual server that meets these requirements:

RequirementDetails
OSAlmaLinux 8, AlmaLinux 9,
CentOS 7, CentOS Stream,
Debian 10, Debian 11, Debian 12,
Ubuntu 18, Ubuntu 20, Ubuntu 22, Ubuntu 24
CPUMinimum 4 cores/8 threads
RAMMinimum 4 GB
Recommended 8 GB
Free disk spaceMinimum 40 GB
Allowed connections to portsTCP 443 (web server)
TCP 5671 (RabbitMQ messaging service)

Note:

The Management Node cannot run on a virtual server based on Xen.

Installation

To install the SolusVM management node, follow these steps:

  1. Log in to the server via SSH.
  2. Download the SolusVM installer script:
    curl https://installer.dev.solusvm.com/latest -o installer
  3. Make the script executable:
    chmod +x ./installer
  4. Start the interactive installer:
    ./installer
  5. Read and accept the end-user license agreement.
  6. Enter your email address. It will be used as the login for your SolusVM Administrator account.
  7. Enter a resolvable hostname or IP address for the Management Node.

After installation, the system displays your login, password, and a one-time login link. Use this link to log in to the SolusVM Administrator web interface for the first time.

Logging In to SolusVM

Note:

When you log in to SolusVM for the first time, you may see a warning about an untrusted SSL/TLS certificate. If you specified an internal IP address during the installation, SolusVM secures the connections to and from the web interface with a self-signed SSL/TLS certificate. Otherwise, Solus VM uses a free SSL/TLS certificate from Let’s Encrypt is used. In either case, the connections to and from the web interface are securely encrypted.

To log in to SolusVM after the first login:

  1. Go to the Management Node URL, either https://<management-server-hostname>/admin or https://<management-server-IP>/admin.
  2. Enter the email address that you specified during the installation as your login and the password that displayed after the installation.
  3. Click Log In.

You have logged in to the SolusVM Administrator web interface.

SolusVM administrator interface after successful login

Additional Information

Installation Directory

SolusVM is installed to the /usr/local/solus directory.

Logs

Check logs if you face any issues during SolusVM installation or administration:

  • You can find installation logs in the /var/log/solus directory.
  • All SolusVM services write their logs to /var/log/messages (CentOS) or /var/log/syslog (Debian®, Ubuntu).

Next Steps

You installed SolusVM, set it up as the administrator, and created a server as a customer. Consider these next steps:

  • Set up billing integration if you plan to sell servers.
  • Explore other advanced features of SolusVM, such as setting limits on compute resources. This feature helps you prevent resource overuse.
  • Change SolusVM update settings in Settings > System Updates. By default, SolusVM automatically installs updates. You can choose which updates to install (for example, testing or stable ones) and when (the desired weekdays and time), or you can switch to manual updates. Learn more in SolusVM Updates.
  • See the RESTful API documentation.
Prev
Overview
Next
Administration
×