> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Proxmox VE API Credentials

> Store a Proxmox VE API URL and token in Ankra to provision and manage self-managed Proxmox clusters.

<Warning>
  **Proxmox VE clusters are in closed beta.** The workflow is still evolving and access is limited. [Contact us](mailto:support@ankra.io) to request access before relying on it.
</Warning>

Proxmox VE API credentials store the Proxmox API URL and an API token, used to provision and manage self-managed [Proxmox VE clusters](/guides/proxmox-clusters). The token needs VM management privileges (for example `VM.Allocate`, `Datastore.AllocateSpace`) on the target node, storage, and bridge.

<Note>
  Proxmox VE credentials are managed from the **portal or API** - there is no `ankra credentials proxmox` CLI command.
</Note>

## Creating a Proxmox VE API Credential

<Steps>
  <Step title="Create an API token in Proxmox">
    1. In the Proxmox VE web UI, go to **Datacenter** → **Permissions** → **API Tokens**
    2. Create a token for a user with VM management privileges and copy the **token ID** and **secret**
  </Step>

  <Step title="Add to Ankra (UI)">
    Go to **Credentials** → **Add** → **Proxmox VE**, enter a name, the API URL, and the token ID and secret. For environments that are not directly reachable, attach an **SSH jumphost** (host, port, username, private key); for self-signed certificates, enable **TLS insecure** (`tls_insecure`).
  </Step>
</Steps>

For Proxmox clusters you also need an [SSH key credential](/platform/credentials/ssh-key), created from the portal or generated via another provider's CLI.
