Add a Proxmox VE server

To manage a Proxmox VE cluster, you add it to Aprox once with its address and the account you want to use. You can add a single node or any node of a cluster; Aprox then shows the whole cluster. Adding servers is free, and you can add as many as you like.

Where to find it

• Sidebar toolbar › Add Server (+).
• In an empty sidebar: Add Server.
• On a Mac, or an iPad with a keyboard: press ⌘N, or choose File › Add Server….

Add the server

1. Open Add Server.
2. Under General, set Type to Proxmox VE. Changing the type also sets the port to 8006.
3. Optional: enter a Name (optional). This is the label in the sidebar, for example Homelab. Without a name, the sidebar shows host:port.
4. Enter the Host: a host name or IP address, for example pve1.example.com or 192.168.1.10. You can also paste a full address such as https://pve.example.com:8006. When you leave the field, Aprox trims it to the host and moves the port into Port.
5. Check the Port. The default for Proxmox VE is 8006.
6. Under Authentication, choose the Method: Password or API Token. See Sign-in methods and two-factor for the differences.
7. Choose the Realm. Tap Refresh realms from server to load the realms the server offers, for example pam (Linux PAM) or pve (Proxmox VE authentication). The default is pam. If the server uses a self-signed certificate, the certificate prompt appears right here. Compare the fingerprint and tap Trust This Certificate. See Self-signed certificates.
8. Enter the Username without the realm, for example root or admin.
9. Enter the credentials:
   • Password method: optionally enter the Password here and turn on Save password to Keychain. You can also leave the password empty and enter it when you sign in.
   • API Token method: enter the Token name and the Token secret. The Token ID below shows the full ID as Proxmox knows it, for example root@pam!aprox. See Create an API token.
10. Under Security, leave Skip TLS validation off. Aprox offers the certificate's fingerprint on the first connection instead.
11. Tap Save.

Fields at a glance

Sign in for the first time

1. Tap the server in the sidebar. It expands. With a saved password or token secret, Aprox signs in right away and you can skip the next steps. Otherwise the server shows a Sign in row.
2. Tap Sign in ("Tap to log in"). The sign-in screen opens.
3. Sign in:
   • Password: enter the Password, decide on Save password to Keychain, and tap Login.
   • API Token: if you entered the secret when you added the server, Aprox connects at once. Otherwise enter the Token secret and tap Connect.
4. If the certificate is not trusted yet, compare the fingerprint and tap Trust This Certificate.
5. If your account uses two-factor authentication, choose the method, enter the Code and tap Verify.

Once you are signed in, the server shows a green dot. Its expanded section lists Cluster Overview, the nodes, guests and storages, Cluster Tasks and Backup Jobs. The detail pane opens the Cluster Overview.

On Android

The steps and labels are the same. The sheet is titled Add Server (or Edit Server), with Save and Cancel. Under Host, the hint reads "Name or IP address. A pasted address is trimmed to its host." The password option is also called Save password to Keychain; Android keeps the password in encrypted storage on the device.

Good to know

• A server reachable only through a VPN needs the VPN connected first.
• A server on your local network needs the local network permission. See Local network access.
• Aprox only connects over HTTPS.

Related

• Sign-in methods and two-factor
• Create an API token
• Self-signed certificates
• Edit, sign out or remove a server
• Add a Proxmox Backup Server