proxmox/scripts/README.md

Project Root Scripts

This directory contains utility scripts for managing the Proxmox workspace project.

Setup Scripts

setup.sh

Initial setup script that creates .env file and Claude Desktop configuration.

Usage:

./scripts/setup.sh

complete-setup.sh

Complete setup script that performs all setup steps including dependency installation.

Usage:

./scripts/complete-setup.sh

verify-setup.sh

Verifies that the workspace is properly configured and all prerequisites are met.

Usage:

./scripts/verify-setup.sh

Environment Configuration

configure-env.sh

Quick configuration script to update .env with Proxmox credentials.

Usage:

./scripts/configure-env.sh

load-env.sh

Standardized .env loader function. Can be sourced by other scripts.

Usage:

source scripts/load-env.sh
load_env_file

Or run directly:

./scripts/load-env.sh

Token Management

create-proxmox-token.sh

Creates a Proxmox API token programmatically.

Usage:

./scripts/create-proxmox-token.sh <host> <user> <password> [token-name]

Example:

./scripts/create-proxmox-token.sh 192.168.11.10 root@pam mypassword mcp-server

update-token.sh

Interactively updates the PROXMOX_TOKEN_VALUE in ~/.env.

Usage:

./scripts/update-token.sh

Testing & Validation

test-connection.sh

Tests the connection to the Proxmox API using credentials from ~/.env.

Usage:

./scripts/test-connection.sh

validate-ml110-deployment.sh

Comprehensive validation script for deployment to ml110-01.

Usage:

./scripts/validate-ml110-deployment.sh

This script validates:

• Prerequisites
• Proxmox connection
• Storage availability
• Template availability
• Configuration files
• Deployment scripts
• Resource requirements

Script Dependencies

All scripts use the standardized ~/.env file for configuration. See docs/ENV_STANDARDIZATION.md for details.

Environment Variables

All scripts expect these variables in ~/.env:

• PROXMOX_HOST - Proxmox host IP or hostname
• PROXMOX_PORT - Proxmox API port (default: 8006)
• PROXMOX_USER - Proxmox API user (e.g., root@pam)
• PROXMOX_TOKEN_NAME - API token name
• PROXMOX_TOKEN_VALUE - API token secret value