e7d1c33cd5fb3570d15da2b9f7feaa50b4d747af
Aprendido desplegando cotizador (Next.js+FastAPI+Postgres, Docker Compose, repo privado) en coolify.urieljareth.org (v4.1.2): - Documenta que /applications/* devuelve 404 en esta instancia y que configurar apps git build-from-source solo es posible por la UI web. - Nuevos scripts scripts/coolify-ui/: coolify-login.mjs (guarda storageState) y Configure-CoolifyComposeApp.mjs (build pack -> Docker Compose, Reload Compose File, env vars por Developer view, dominios por servicio). - references/coolify-4.1.2-notes.md: mapa de API funcional/404, gotchas (BOM UTF-8 rompe el parser YAML de Coolify; Reload Compose File obligatorio; pin de dominios por servicio o 503; no encolar deploys concurrentes; PowerShell [IO.File]::ReadAllText para payloads de llaves). - env.local.template.ps1: COOLIFY_EMAIL/COOLIFY_PASSWORD para la UI. - SKILL.md/TOOLS.md: seccion "instance reality" y flujo UI paso a paso. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Proxmox & Coolify Manager
Proyecto local para operar Proxmox con ayuda agentica desde Codex.
La idea practica es simple: este repo guarda el contexto, los runbooks y los scripts seguros para que Codex pueda diagnosticar y ayudarte a gestionar el host Proxmox local sin depender de memoria suelta ni de secretos pegados en Markdown.
Estado verificado
Verificado el 2026-05-30 desde esta maquina:
- Host Proxmox:
192.168.0.200 - Nodo:
thinkcentre - Version: Proxmox VE
9.1.1 - Kernel:
6.17.2-1-pve - LXC detectados:
100 hermes,102 coolify - Docker corre dentro del LXC
102 - SSH con clave local funciona
- API REST autenticada funciona cuando el token se carga desde entorno
Estructura
agent/SKILL.md: reglas operativas para que Codex actue como agente Proxmox.agent/TOOLS.md: comandos seguros y patrones de uso.coolify_skill/: skill local para operar Coolify, Docker en LXC102y API de Coolify sin guardar secretos.docs/proxmox-inventory.md: inventario verificado y notas de arquitectura.docs/runbooks/: procedimientos concretos para conexion, diagnostico y Coolify.docs/runbooks/nextcloud.md: recuperacion y fix HTTPS para Nextcloud.docs/runbooks/baserow.md: puesta en vivo de Baserow y fix red/Traefik.scripts/: wrappers PowerShell para SSH, API e inventario.PROXMOX/,proxmox-agent/,proxmox-skill/: carpetas legacy que ahora apuntan a la documentacion viva.
Configuracion local
Los secretos no viven en el repo. Usa variables de entorno o un archivo privado
ignorado por Git, por ejemplo .env.local.ps1.
Plantilla:
.\scripts\Set-ProxmoxEnv.example.ps1
Prueba de conexion:
.\scripts\Test-ProxmoxConnection.ps1
Inventario rapido:
.\scripts\Get-ProxmoxInventory.ps1
Comando SSH puntual:
.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct list"
Reglas de operacion
- Primero diagnostico de solo lectura.
- Cambios destructivos requieren confirmacion explicita: borrar, reiniciar, apagar, editar red, mover discos, actualizar paquetes o modificar servicios.
- Preferir scripts del repo antes que comandos manuales largos.
- No registrar tokens, passwords ni claves privadas en Markdown.
Languages
PowerShell
69%
Shell
21.7%
JavaScript
8.5%
PHP
0.8%