How-to guide

SSH into a Maxedge & check service status

Fetch the per-unit key from Vault, connect to the VM and check the dockerized services. Works from the service VLAN on site or through an eHawk session.

Host

192.168.30.111 (Maxedge VM)

User

maxedge

Key

Vault → lh/maxedge/ssh (per unit, rotated)

Network

Service port 12 (VLAN 99) or eHawk

Get the key

Open Vault → lh/maxedge/ssh → select the unit → copy the private key.
Save it as ~/.ssh/maxedge_key and restrict permissions: chmod 600 ~/.ssh/maxedge_key.

Connect and check services

ssh -i ~/.ssh/maxedge_key maxedge@192.168.30.111

docker ps                    # running containers
docker compose -f /opt/maxedge/docker-compose.yml ps
docker logs -f export-maxcloud
docker restart <service>

Everything in the VM is dockerized — a healthy unit shows all services Up. VM status itself: Proxmox UI → node → VM maxedge.

Useful paths

Path	What
/opt/maxedge/docker-compose.yml	Service definitions and versions
/opt/maxedge/config/	Active signal/config files (see config guide)
/opt/maxedge/rope-analyzer/license/	Rope Analyzer `.lic` files
/var/lib/maxedge/data/	Local time-series store and export buffer — watch disk usage (`df -h`)

Cannot connect? Follow the runbook Cannot SSH into Maxedge →