Managing Proxmox VE from Your iPhone

Why Safari Cannot Handle the Proxmox Web UI

If you have ever tried to manage Proxmox VE from Safari on your iPhone, you know the experience is painful. The Proxmox web interface is built with ExtJS, a desktop-oriented JavaScript framework that renders a fixed-width layout regardless of screen size. On an iPhone, this means you get the full desktop interface crammed into a screen that is roughly one-fifth the width it was designed for.

Safari on iOS adds its own complications. The address bar and toolbar consume screen space. Pinch-to-zoom fights with the page's own scroll behavior. The noVNC console — critical for emergency VM access — is virtually unusable because the iOS keyboard covers the console output and touch events conflict with Safari's gestures. Double-tapping to zoom when you meant to double-click inside a VM, accidentally triggering the back swipe when scrolling horizontally through a table, losing your session when Safari reloads a background tab — these are not hypothetical problems, they are the everyday reality of trying to use Proxmox on an iPhone.

The solution is not a better browser. It is a native app designed specifically for this purpose.

Download ProxmoxR from the App Store

ProxmoxR is a native iOS app built for managing Proxmox VE from your iPhone and iPad. You can download it from the App Store and start a 7-day free trial immediately. The app requires iOS 16 or later and works on all modern iPhone models.

Step-by-Step Setup

Step 1: Create an API Token on Your Proxmox Server

ProxmoxR connects to your Proxmox server using API tokens, which is the most secure authentication method available. API tokens let you grant specific permissions without exposing your main account password, and you can revoke them independently at any time.

SSH into your Proxmox server and create a dedicated user and API token:

# Create a dedicated user for the mobile app
pveum user add proxmoxr@pve -comment "ProxmoxR Mobile App"

# Assign the PVEAuditor role for read-only access, or PVEAdmin for full control
pveum aclmod / -user proxmoxr@pve -role PVEAdmin

# Create an API token for the user
pveum user token add proxmoxr@pve mobile-app --privsep 0

The last command will output a token ID and a token secret. Copy the secret immediately — it is only displayed once and cannot be retrieved later. It will look something like this:

Token ID: proxmoxr@pve!mobile-app
Secret: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Step 2: Add Your Cluster in ProxmoxR

Open ProxmoxR on your iPhone and tap the button to add a new cluster. Enter the following details:

• Hostname or IP: The address of your Proxmox node (e.g., 192.168.1.100 or pve.yourdomain.com).
• Port: The default is 8006. Change this only if you have configured a custom port.
• Token ID: The full token ID from the previous step (e.g., proxmoxr@pve!mobile-app).
• Token Secret: The secret value you copied earlier.

Tap connect, and ProxmoxR will establish a direct connection to your Proxmox API. If your server uses a self-signed SSL certificate, the app will prompt you to trust it.

Step 3: Verify the Connection

Once connected, you should see your cluster's nodes, VMs, and containers listed in the app. Tap on a node to verify that resource metrics are loading correctly. Try tapping on a VM to confirm you can see its details. If everything loads, your setup is complete.

iPhone-Specific Features

Haptic Feedback

ProxmoxR takes advantage of the iPhone's Taptic Engine to provide haptic feedback for important actions. When you start or stop a VM, you get a subtle confirmation through touch — a reassuring physical response that tells you the action was registered without needing to stare at the screen. This is particularly useful when you are performing quick actions and want tactile confirmation that you tapped the right button.

Face ID and Biometric Security

Because ProxmoxR stores API tokens that provide access to your infrastructure, security matters. On iPhones with Face ID, you can require biometric authentication to open the app. This adds a layer of protection in case your phone is unlocked and someone else picks it up — they cannot access your Proxmox clusters without your face. On older iPhones, Touch ID serves the same purpose.

Optimized for iOS

ProxmoxR follows iOS design conventions, so it feels like a native Apple app rather than a wrapped web page. Navigation uses standard iOS patterns — swipe back, pull to refresh, smooth scrolling lists. The interface adapts to your iPhone's display size and respects your system settings like Dark Mode and text size preferences.

Real-World Usage on iPhone

Quick Status Checks

The most common mobile task is checking that everything is running. Open ProxmoxR, and your cluster health is immediately visible — nodes online, guests running, resource utilization. You can confirm that your backup completed, verify that a VM you restarted earlier came back online, or check disk space on a storage pool. These checks take seconds, not the minutes of pinch-zooming required by the web UI in Safari.

Emergency VM Restarts

When you get paged at 2 AM that a VM is down, speed matters. With ProxmoxR on your iPhone, the workflow is: unlock phone, open app, tap the affected VM, tap Start or Reboot. The entire process takes under ten seconds. Compare that to opening Safari, navigating to your Proxmox host, logging in, finding the VM in the tiny resource tree, and trying to tap the correct button without hitting Stop instead of Restart.

Console Access

When you need to interact with a VM's console — troubleshooting a boot failure, fixing a network configuration that locked you out of SSH, or entering BIOS settings — ProxmoxR's built-in console viewer works properly on the iPhone screen. The console is scaled to fit, touch input is mapped correctly, and the keyboard does not completely obstruct the display. It is not a replacement for a proper terminal session, but it is genuinely usable for emergency troubleshooting.

Backup Verification

After running backup jobs, you can check their status from your iPhone. See which backups completed successfully, which failed, and how much storage space they consumed. If a backup failed, you can investigate the reason and rerun it without waiting until you are back at your desk.

iPad Support

ProxmoxR also runs on iPad, where the larger screen provides an even better management experience. On an iPad, you get more information visible at once — wider tables, larger graphs, and more room for the console viewer. If you carry an iPad, ProxmoxR on the bigger screen approaches the usability of the desktop web UI while remaining fully touch-optimized. It is an excellent option for on-site work where you want more screen space than a phone but do not want to bring a laptop.

Get Started

Download ProxmoxR from the App Store and connect it to your Proxmox server today. The 7-day free trial gives you full access to every feature, so you can evaluate whether it fits your workflow before subscribing. Plans start at just €1/month, with annual (€7.99/year) and lifetime (€29.99) options available.