Proxmox-Coolify-Manager/agent/TOOLS.md

Tooling

All commands assume PowerShell from the project root.

Environment

. .\.env.local.ps1

If no private env file is loaded, SSH still uses the local defaults from scripts/ProxmoxAgent.ps1. API calls require token env vars.

Smoke test

.\scripts\Test-ProxmoxConnection.ps1

Inventory

.\scripts\Get-ProxmoxInventory.ps1

SSH wrapper

.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct list"
.\scripts\Invoke-ProxmoxSsh.ps1 -Command "qm list"
.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker ps -a"

API from a PowerShell session

. .\scripts\ProxmoxAgent.ps1
Invoke-ProxmoxApi -Path "/version"
Invoke-ProxmoxApi -Path "/nodes"
Invoke-ProxmoxApi -Path "/cluster/resources"

Commands that require confirmation

• pct start, pct shutdown, pct reboot, pct stop, pct destroy
• qm start, qm shutdown, qm reboot, qm stop, qm destroy
• docker restart, docker stop, docker rm, docker compose up/down
• package updates, firewall edits, network edits, storage edits