brian/incus-commander
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases 2 Packages Wiki Activity Actions
2 releases 2 tags
  • v0.4.0 3d03838292

    Release v0.4.0 — Local Images & VGA SPICE Console Stable

    brian released this 2026-07-15 17:49:44 +00:00 | 0 commits to main since this release

    New Features

    ###Local Images Management

    • Upload images from your local machine to any Incus system
    • Download images from Incus systems to your local machine
    • Delete images with confirmation
    • View image details (aliases, size, properties, creation date)
    • Remote image server management (create, list, delete remotes)

    Native VGA Console (SPICE)

    • Open a full graphical console for virtual machines directly in the browser
    • Uses the SPICE protocol via spice-client for near-native display performance
    • Keyboard and mouse input forwarded in real-time
    • Fullscreen mode and Ctrl+Alt+Del toolbar
    • Containers are greyed out with tooltip (VGA only available for VMs)
    • Short-lived JWT tokens (60s expiry) for secure WebSocket connections
    • Per-channel WebSocket proxy with essential channel filtering (rejects playback, record, port, webdav channels)

    Instance Templates

    • Auto-system selection when creating instances from templates

    Backend Changes

    • Image upload/download streaming with progress tracking
    • VGA console token endpoint (POST /api/console/vga-token)
    • Per-channel SPICE WebSocket proxy (WS /api/console/vga/{systemId}/{name})
    • Image remote management endpoints
    • Certificate helpers for system connections
    • Settings defaults for image management

    Frontend Changes

    • LocalImagesView — full CRUD UI for images with upload modal, detail drawer
    • VgaConsoleView — SPICE client rendering with fullscreen and toolbar
    • VGA console launch from instance menus (admin and non-admin)
    • Router: /console/vga/:systemId/:name route
    • Updated profiles and instances views

    Infrastructure

    • Upgraded Docker base images: node:22-alpine, python:3.13-slim, nginx:alpine
    • Added spice-client npm dependency

    Test Coverage

    • 15 new backend console API tests (token creation, validation, expiry, role gating)
    • New backend image management API tests
    • Frontend VGA console unit tests
    • E2E tests for image management and VGA console navigation

    Docker Image

    docker pull bmcgonag/incus-commander:0.4.0
    docker pull bmcgonag/incus-commander:latest

    Downloads