PokePVE is a native iPhone client for managing Proxmox VE servers. This page collects common questions and the best ways to reach us. If you can’t find what you’re looking for, just drop us a line.

View PokePVE on the App Store

Contact Us

To help us diagnose issues quickly, please include the following when you write in:

  • Device model and iOS version (e.g. iPhone 17 Pro / iOS 26.1)
  • PokePVE version (Settings → About → About App)
  • Proxmox VE server version (e.g. PVE 8.3)
  • Steps to reproduce, expected result, and actual result
  • A screenshot or short log when applicable

Frequently Asked Questions

Getting Started & Connecting

How do I add my Proxmox server?

Open PokePVE, go to the Settings tab, and tap Add Server under the Servers section. Fill in the form:

  • Basic: name, server URL (e.g. https://192.168.1.10:8006), and whether to Verify SSL.
  • Authentication: choose Password or API Token, then enter username, realm (e.g. pam / pve), and either the password or Token ID + Token Secret.

Once saved, the app will immediately try to connect and verify the credentials. With multiple servers added, tap any entry in the Servers list to switch.

Which authentication methods are supported?

Two methods are supported:

  • Password: same as the web console — username + realm (e.g. root + pam, user + pve).
  • API Token: created in PVE under Datacenter → Permissions → API Tokens. In the app, enter username, realm, Token ID, and Token Secret.

For production use, API Tokens are recommended — they support fine-grained permissions and can be revoked at any time.

What about “certificate not trusted” / self-signed certificate warnings?

Proxmox uses self-signed certificates by default, and the app validates them per system policy. Recommended order:

  1. Configure a trusted certificate for Proxmox (e.g. via ACME / Let’s Encrypt) — this is the safest option.
  2. Trust your self-signed root via iOS Settings → General → VPN & Device Management → Certificate Trust Settings.
  3. Edit the server inside the app and turn off the Verify SSL toggle under Basic — only do this on a network and server you fully trust.

How do I troubleshoot timeouts or connection refused errors?

  • Make sure your iOS device can reach the Proxmox server. From outside your LAN, you’ll likely need a VPN or reverse proxy.
  • Double-check the server URL, port (default 8006), and protocol (https://).
  • Confirm the PVE host firewall isn’t blocking the relevant port.
  • If you use a reverse proxy, make sure it forwards WebSocket upgrade requests (required for VNC, terminal, etc.).

Subscription / Pro Features

What’s included in Pro?

Browsing, connecting, and routine management are free. PokePVE Pro unlocks four advanced capabilities:

  • noVNC console: operate VMs through a graphical console inside the app.
  • SSH / serial terminal: SSH into VMs and containers, and access VM serial terminals.
  • Hardware editor: add and edit VM / CT hardware, including disks, network interfaces, USB devices, and more.
  • Multiple servers: the free tier allows 1 server; Pro removes the limit.

The exact list shown in the in-app paywall is authoritative.

How do I purchase Pro?

Go to the Settings tab and tap Upgrade to Pro at the top to open the paywall — or tap any Pro-locked feature to bring it up. All payments are processed by Apple; PokePVE never sees your payment details. Once subscribed, the top of Settings will read PokePVE Pro Unlocked.

How do I restore my purchase on a new device?

Open Settings → Upgrade to Pro to bring up the paywall, then tap Restore Purchase. Make sure you’re signed in with the same Apple ID you used for the original purchase.

Can the subscription be shared across devices or via Family Sharing?

  • Multiple devices signed in with the same Apple ID can share the subscription.
  • Family Sharing: not enabled in the current version. If this matters to you, please write in — we’ll evaluate enabling it in a future release.

How do I request a refund?

Refunds are handled by Apple — PokePVE cannot issue them directly. Visit reportaproblem.apple.com, sign in with your Apple ID, locate the PokePVE order, and submit a refund request. Email us if you need supporting information.

Where do I cancel the subscription?

Open iOS Settings → [your Apple ID] → Subscriptions → PokePVE to manage or cancel. You’ll keep Pro features for the rest of the current billing period; afterwards the app reverts to the free tier automatically.

Security & Privacy

Does PokePVE upload my server passwords or tokens to the cloud?

No. PokePVE has no account system. All server credentials stay on your device and are never uploaded to our servers or any third party.

Where exactly are credentials stored?

All sensitive credentials (passwords, API Token secrets, post-login tickets) are stored in the iOS Keychain, encrypted and managed by the system; other apps cannot read them. Non-sensitive metadata such as server URL and username are stored in the app’s local database.

How does biometric authentication (Face ID / Touch ID) work?

Open Settings → Security → App Lock to enable it, then choose an Auto-lock After interval (the app will require authentication when reopened after backgrounding for that long). Authentication uses Face ID / Touch ID or your device passcode and runs entirely on-device — PokePVE never sees your biometric data.

If the system has no Face ID / Touch ID or device passcode configured, the app will prompt: Enable Face ID / Touch ID or a device passcode in Settings first.

Does the app collect usage data?

PokePVE bundles no third-party analytics or ad SDKs and collects no data about your interactions with PVE. Anonymous subscription events are processed by RevenueCat solely to validate and restore purchases. See the privacy policy for the full breakdown.

Using the App

VNC or the terminal won’t connect — what should I check?

  • Make sure the target VM / container is running and the relevant console is enabled.
  • If you reach PVE through a reverse proxy, make sure it forwards WebSocket upgrade requests.
  • Check that the PVE host firewall allows the required port range.
  • If you log in with an API Token, make sure it has the necessary permissions, such as VM.Console.

What appears in the Tasks tab?

The Tasks tab shows two kinds of tasks together:

  • Local tasks: write operations you trigger inside the app (start / stop / create / delete / …). The app polls each via its UPID.
  • Server tasks: the recent task list pulled directly from the PVE server, including tasks initiated by other clients or the web UI.

How do I view or create backups?

Navigate to a node → Storage → pick a backup-capable storage (e.g. PBS, local directory) → the Backup tab. You can trigger an on-demand backup from a VM / container detail page; scheduled backups still need to be configured in the PVE web console.

What’s the difference between cluster and standalone mode?

  • Standalone: connect to a single Proxmox host — every feature works as expected.
  • Cluster: connect to any cluster node and the app automatically lists all nodes, VMs, containers, and shared storage across the cluster, with cross-node browsing and (where permissions allow) migration.

Feedback & Suggestions

If you’ve found a bug, want to request a feature, or just want to say hi, write to us at apps@1248.ink. Every email gets read.

If PokePVE has been useful to you, consider leaving a review on the App Store — that’s the biggest way to support an indie developer.