Connect a Server

Supported providers

LarVPS works with any VPS provider that gives you root SSH access:

• Linode / Akamai
• DigitalOcean
• Vultr
• Hetzner
• AWS Lightsail / EC2
• Google Cloud
• Oracle Cloud (Free Tier)
• Any dedicated server or self-hosted machine

Requirements

Requirement	Minimum
OS	Ubuntu 22.04 or 24.04
RAM	512 MB (1 GB recommended)
Disk	10 GB
Access	Root via SSH
Network	Public IPv4 address

In the dashboard

1. Open Servers.

2. Click Add Server.

3. Name the machine in a way your team will understand later. Good examples:

   • Production WordPress
   • EU App Server
   • Client A Primary

4. Copy the command LarVPS prepares for that specific server.

5. SSH into the VPS and paste it.

6. Return to Servers and wait for the health badge to move from provisioning into connected.

Lưu ý

Use a fresh server when possible. LarVPS expects to manage Nginx, PHP, and firewall defaults itself.

What LarVPS is doing during install

The UI only asks you to paste one command, but behind the scenes the installer is checking and preparing:

• supported Ubuntu version
• agent binary installation
• systemd service registration
• firewall defaults
• required packages for the platform

Health states to watch

After installation, your server should appear in the Dashboard within 30 seconds. Wait for the health badge before moving into Sites. You’ll see:

• Connected: safe to move into Sites
• Connecting: agent is still reporting initial data
• Disconnected: LarVPS has not heard from the agent recently
• Updating: the machine is processing a server-level task

If the server shows Disconnected, open its row actions and check:

• recent command logs
• heartbeat age
• the SSH connection to that VPS

Optional preflight

If you want to verify a VPS before the full install, you can run:

larvps system:preflight --short

Use --json only when another UI or automation needs structured output.

Removing a server

Delete it from the dashboard when you no longer want LarVPS to manage it.

The operator is still responsible for what happens on that VPS after disconnecting it.