Securely Managing Your Virtualization Environment: A Guide to Proxmox API Authentication with Python

⚗ Kevin Summersill 🔋
3 min readFeb 24, 2023

Proxmox is a popular open-source virtualization management platform that allows you to manage virtual machines, containers, and other resources through an API. In this article, we’ll go over how to authenticate to the Proxmox API using Python.

Before we get started, you’ll need to have a few things set up. First, you’ll need to have Python installed on your machine. If you don’t have Python installed, you can download and install it from the official website. Additionally, you’ll need to have the proxmoxer library installed, which you can install by running the following command in your terminal:

pip install proxmoxer

Once you have these prerequisites installed, you can get started with authentication.

Step 1: Getting your Proxmox credentials

The first step in authenticating to the Proxmox API is to obtain your Proxmox credentials. These consist of your Proxmox hostname, username, password, and optionally a realm. You can obtain these credentials by logging in to the Proxmox web interface and navigating to the “Authentication” tab in the “Datacenter” view.

Step 2: Creating a Proxmox API client object

Once you have your Proxmox credentials, you can create a client object using the proxmoxer library. The proxmoxer library provides a convenient way to interact with the Proxmox API. Here's an example of how to create a client object:

from proxmoxer import ProxmoxAPI
proxmox = ProxmoxAPI('your-proxmox-hostname', user='your-username', password='your-password', verify_ssl=False)

In this example, we’re creating a client object and passing in the Proxmox hostname, username, password, and verify_ssl=False parameter to disable SSL certificate verification. If your Proxmox server uses a self-signed certificate, you'll need to set verify_ssl=False to avoid SSL certificate errors.

Step 3: Authenticating to the Proxmox API

With the client object created, we can now authenticate to the Proxmox API. We can do this by calling the login method on the client object:




⚗ Kevin Summersill 🔋

Enterprise Solution Architect | Certified K8s Administrator/Developer ⚓ | SAFe SPC | Cert Terraform | AWS Solutions Architect | Dev*Ops/GitOps Engineer 🔥