PVE CLI Tool

A TUI-based tool for managing Proxmox VE.

Features

• TBD

Installation

1. Clone the repository:

   git clone https://github.com/your-username/pve-cli-tool.git
   cd pve-cli-tool

2. Install dependencies:

   go mod tidy

3. Build the application:

   go build -o pve-cli-tool cmd/pve-cli-tool/main.go

Configuration

This application is configured via a .env file. Copy the .env.example file to .env and fill in your Proxmox server details.

cp .env.example .env

Authentication

The tool supports two authentication methods:

1. API Token (Recommended)
2. User and Password

API Token

To use API token authentication, you need to generate a token in your Proxmox VE web interface.

1. Log in to your Proxmox VE web UI.
2. Go to Datacenter -> Permissions -> API Tokens.
3. Click Add.
4. Select a User (e.g., root@pam).
5. Enter a Token ID (e.g., pve-cli-tool).
6. Uncheck Privilege Separation.
7. Click Add.
8. A dialog will appear with the Token ID and Secret. Copy the secret immediately, as it will not be shown again.
9. In your .env file, set the following variables:

   PROXMOX_API_TOKEN_ID="your-token-id"
   PROXMOX_API_TOKEN_SECRET="your-secret"
   

User and Password

To use user and password authentication, set the following variables in your .env file:

PROXMOX_USER="your-user"
PROXMOX_PASSWORD="your-password"

Note: If both API token and user/password are provided, the API token will be used.

Usage

./pve-cli-tool