# netbox-proxbox v0.0.9

netbox-proxbox v0.0.9

| Field |Value |
| --- | --- |
| Canonical URL | https://emersonfelipesp.com/netbox-proxbox/releases/v0.0.9 |
| GitHub URL | https://github.com/emersonfelipesp/netbox-proxbox/releases/tag/v0.0.9 |
| Tag | v0.0.9 |
| State | stable |
| Author | emersonfelipesp |
| Created | 2026-04-01 03:09 UTC |
| Published | 2026-04-01 03:04 UTC |
| Target | develop |
| Synced | 2026-08-24 18:36 UTC |
| Assets | 0 |

## Release notes

## 🎉 v0.0.9 Release

### New Features

#### Storage Management
- **ProxmoxStorage Model**: New data model for tracking Proxmox storage datastores in NetBox
  - Links to virtual disks, backups, and snapshots
  - Storage usage tracking with live updates
  - Enhanced storage detail page with related objects

#### VM Snapshots & Backups
- **VMSnapshot Model**: Sync Proxmox VM snapshots into NetBox
  - Timestamp and size tracking
  - Linked to parent VMs and storage
  - CRUD views and list filtering

- **VMBackup Model**: Sync Proxmox VM backup jobs and restore points
  - Backup metadata and scheduling info
  - Storage location tracking
  - Backup status and size monitoring

#### Task History
- **VMTaskHistory Model**: Track Proxmox async tasks and operations
  - Task execution logs and status
  - Detailed error tracking
  - Full CRUD views for audit trails

#### Sync Enhancements
- **Per-VM Sync**: Added "Sync Now" action on individual VM detail pages
  - Selective syncing of specific virtual machines
  - Improved UI responsiveness with per-VM actions
  
- **Snapshots in Full Update**: Added snapshots to the full synchronization pipeline
  - Complete Proxmox infrastructure discovery
  - Multi-stage sync orchestration

- **Configurable Fetch Concurrency**: New plugin setting to tune backend sync performance
  - Balance between throughput and resource usage
  - Per-endpoint configuration support

#### Job UI & Real-time Progress
- **Live SSE Streaming**: Real-time job progress via Server-Sent Events
  - Live log streaming to NetBox UI
  - Stage-based progress tracking
  - Better visibility into long-running sync operations

- **Stage Progress Bar**: Visual progress indication for multi-stage sync jobs
  - Clear breakdown of sync phases (Devices → Storage → Snapshots → Backups)
  - Real-time status updates

### Improvements & Fixes

#### UI/UX
- Improved job progress bar layout and styling
- Fixed storage detail page empty Summary card handling
- Added links to all dashboard count values for quick navigation
- Enhanced endpoint status badges with connectivity details
- Removed redundant log message divs from plugin pages

#### Data Integrity
- Fixed serializer, viewset, and error handling issues
- Improved error handling and backpressure management
- Enhanced thread-safety in job processing
- Better timeout configuration for long-running operations

#### Backend Integration
- Fixed URL namespace errors in job live polling alerts
- Improved error detection and reporting for backend failures
- Better connection status tracking for endpoints

#### Code Quality
- Fixed F541 ruff violations (unnecessary f-strings)
- Ruff formatting compliance across codebase
- Enhanced test contracts for frontend/backend parity

### Models Added
- `ProxmoxStorage` - Storage datastore tracking
- `VMSnapshot` - VM snapshot management
- `VMBackup` - Backup job and restore point tracking
- `VMTaskHistory` - Async task and operation logging
- `ProxboxPluginSettings` - Configurable plugin behavior

### API Additions
- New REST endpoints for Storage, Snapshots, Backups, and Task History
- Writable nested serializers for related object assignment
- Bulk import and CSV export for Proxmox endpoints

### Migration Notes
- Migration squashing consolidated storage migrations
- Raw SQL used for `pstart` column timestamp migration
- Fully backwards-compatible with NetBox 4.5.x

### Testing
- 124 tests passing
- Enhanced contract tests for frontend/backend alignment
- Improved sync pipeline testing

**Full Changelog**: https://github.com/emersonfelipesp/netbox-proxbox/compare/v0.0.8...v0.0.9

## Assets

No binary assets attached.

Source archives:

| Format |URL |
| --- | --- |
| zip | https://api.github.com/repos/emersonfelipesp/netbox-proxbox/zipball/v0.0.9 |
| tar.gz | https://api.github.com/repos/emersonfelipesp/netbox-proxbox/tarball/v0.0.9 |