core/backend/modules/updates

Module — Updates

Type: Core (always enabled)

Run apt update && apt full-upgrade on the Proxmox host or any LXC container, with real-time streaming output via WebSocket.

Features

• Target: host, a specific LXC (lxc:100), or all LXC containers at once
• Output streamed line-by-line via WebSocket — no polling required
• Full output saved to update_history table in SQLite
• Admin-only action

API Endpoints

Method	Path	Auth	Description
POST	/api/updates/run	JWT+Admin	Start an update job
GET	/api/updates/history	JWT	List past update jobs (last 50)

POST /api/updates/run

{ "target": "host" }

{ "target": "lxc:100" }

{ "target": "all" }

Response:

{ "job_id": "1710000000-ab3f9z12", "message": "Mise à jour démarrée" }

WebSocket Streaming

Connect to GET /ws/updates/{jobId}?token=<jwt> to receive output in real time.

Message types published on the channel:

Type	Payload	Description
update_output	{ "chunk": "..." }	Line(s) of apt output
update_done	{ "job_id": "..." }	Job completed successfully
update_error	{ "error": "..." }	Job failed

How It Works

Updates run over SSH using the credentials configured during installation:

• Host: runs DEBIAN_FRONTEND=noninteractive apt-get update && apt-get full-upgrade -y directly
• LXC: runs the same command via pct exec <vmid> -- bash -c '...'
• All: iterates over pct list output and updates each container

Requirements

• SSH access to the Proxmox host with sudo/root privileges
• pct available on the host (standard on Proxmox VE)

License

MIT — see LICENSE