Get started
Set up your first cluster
What you need, how to add a Proxmox VE cluster, and what to do the first time macOS and your server ask questions.
Moxie Prox talks to your Proxmox VE servers through their REST API, the same one Proxmox’s web interface uses. You don’t install anything on the servers, and you never need their shell.
What you need
- A Mac with macOS 26 Tahoe or later.
- A Proxmox VE 9 cluster or single node that your Mac can reach. Moxie Prox is developed and tested on Proxmox VE 9.2.
- A Proxmox login: a user and password (with two-factor authentication if you use it), an API token, or an OpenID Connect realm. Moxie Prox can do whatever that login may do in Proxmox, and no more. See Sign in.
Start your free trial
Since version 1.3, Moxie Prox is a free download with a 7-day free trial.
- Open Moxie Prox. The first screen, Try Moxie Prox free for 7 days, says what the trial includes and what it costs afterwards.
- Choose Start Free Trial. The App Store asks you to confirm; nothing is charged.
- Everything works during the trial. Settings › Privacy & About shows the days left and has Buy for $19.99: it keeps Moxie Prox, with a year of new features included.
When the 7 days are up, Your free trial has ended appears and Moxie Prox stops opening your clusters until you buy it. Your saved clusters and settings are kept, and nothing is charged by itself.
On a new Mac? If you have bought Moxie Prox and it asks, choose Restore Purchases (on the first screen, and in Settings › Privacy & About during the free trial) while signed in with the Apple Account you bought it with.
Add a cluster
- Open Moxie Prox. The welcome screen asks you to add a cluster: any node’s address works, and the whole cluster is shown.
- Choose Add… › Proxmox VE Cluster…
- Under Cluster, give it a Name you’ll recognize (for example Home lab), type the node’s Host name or IP address, and check the Port (Proxmox uses 8006).
- Under Authentication, choose how to Sign in with: API Token, Username & Password or OpenID Connect, and fill in the fields.
- Choose Add Cluster.
Pasting a URL works. Paste an address such as
https://pve1.example.com:8006into Host and Moxie Prox fills in the host and the Port for you. In version 1.1, the Host field takes only a name or address, such aspve1.example.com; put the port in Port.
Allow Moxie Prox on your network
Before it connects for the first time, Moxie Prox explains that macOS is about to ask whether it may find and connect to devices on your local network. Choose Got It, then Allow when macOS asks.
If you chose Don’t Allow, or the connection stops working after an update, see Troubleshooting › Local Network.
Trust your server’s certificate
Proxmox VE installs with a self-signed certificate that your Mac doesn’t know. The first time you connect, Moxie Prox shows Unverified certificate, with the server, the certificate’s subject and its SHA-256 fingerprint.
- In Proxmox’s web interface, open Node › System › Certificates and compare the fingerprint shown there with the one in Moxie Prox.
- If they match, choose Trust and Connect.
Moxie Prox remembers (“pins”) that certificate. It also learns the other nodes’ fingerprints from the cluster, so it won’t ask again for each node.
If your servers use a publicly trusted certificate, such as one from Let’s Encrypt, there’s nothing to confirm, and certificate renewals never cause a prompt.
What you see next
Once connected, the sidebar shows your datacenter, its hosts and their guests. Continue with The window for a tour, or go straight to Power and confirmations to start working with guests.
Checked against Moxie Prox 1.3. Updated November 15, 2026.