# netbox-proxbox v0.0.11

v0.0.11

| Field |Value |
| --- | --- |
| Canonical URL | https://emersonfelipesp.com/netbox-proxbox/releases/v0.0.11 |
| GitHub URL | https://github.com/emersonfelipesp/netbox-proxbox/releases/tag/v0.0.11 |
| Tag | v0.0.11 |
| State | stable |
| Author | emersonfelipesp |
| Created | 2026-04-14 04:15 UTC |
| Published | 2026-04-13 20:43 UTC |
| Target | main |
| Synced | 2026-08-24 06:53 UTC |
| Assets | 0 |

## Release notes

## Summary

Version 0.0.11 is a major feature release. It adds Backup Routines, individual per-object sync buttons, a live job panel, a Backend Logs page, non-blocking live log streaming, encryption key storage, extended storage and replication views, endpoint CSV import/export, auto-push of NetBox endpoint config to the backend, three-tier error severity in sync output, and dozens of bug fixes and stability improvements.

## Compatibility

| NetBox   | netbox-proxbox | proxbox-api | netbox-sdk     | proxmox-sdk    |
|----------|----------------|-------------|----------------|----------------|
| >=4.5.7  | v0.0.11        | v0.0.7      | v0.0.7.post4   | v0.0.2.post2   |

NetBox compatibility range: `4.5.0` – `4.5.99` (verified on `v4.5.7` with django-rq `4.0`).

---

## New Features

### Backup Routines
Proxbox now discovers and stores Proxmox `vzdump` backup schedules as **BackupRoutine** objects in NetBox. Each routine captures the job ID, enabled state, schedule (cron expression), storage target, compression mode, and retention policies (`keepLast`, `keepHourly`, `keepDaily`, `keepWeekly`, `keepMonthly`, `keepYearly`). Routines can be synced individually or as part of a Full Update. Bulk edit and bulk import are supported.

### Individual Sync Buttons on All Objects
Every NetBox plugin object (virtual machines, containers, clusters, nodes, backups, snapshots, replications, backup routines, storage) now shows a **Sync Now** button on its detail page. Clicking the button enqueues a targeted sync job for that single object without triggering a full update.

### Live Job Panel and Real-Time Polling
The sync UI now streams job progress through a live panel with stage-by-stage status, log entries, and error counts. Jobs can be followed in real time from the NetBox UI without reloading the page.

### Errors Tab in Live Job Panel
A dedicated **Errors** tab appears in the live job panel when any non-fatal error occurs. Errors are classified into three severity tiers — **critical**, **error**, and **warning** — each shown with a distinct badge colour.

### Backend Logs Page
A new **Backend Logs** page under Plugins → Proxbox streams log output directly from the `proxbox-api` process via SSE with level-based colouring and filters for log level and date range.

### Encryption Key Storage
`ProxboxPluginSettings` gains an **encryption_key** field for storing a secret used to encrypt sensitive Proxmox API tokens at rest, surfaced in a new **Encryption** card on `/proxbox/settings/`.

### Configurable Primary IP Preference
A new setting in `ProxboxPluginSettings` lets operators choose which IP address Proxbox assigns as the primary IP for synced virtual machines.

### Auto-Push NetBox Endpoint Config to Backend
Proxbox now automatically pushes the active `NetBoxEndpoint` (URL + API token) to `proxbox-api` on save, startup, keepalive, and before every sync job — removing the manual backend configuration step.

### Per-Stage Runtime Breakdown
The sync card now shows wall-clock time spent in each pipeline stage after a sync completes.

### Extended Storage Detail Tabs
ProxmoxStorage detail page now has dedicated tabs for Virtual Disks, Backups, and Snapshots with extended fields (content types, shared flag, active status, disk counts).

### Extended Replication Fields
`Replication` objects now expose `endpoint`, `status`, and `raw_config`. Bulk edit and bulk import are supported with a centralised status enum.

### Snapshot Bulk Edit and Bulk Import
VM Snapshots now support bulk edit and bulk import from CSV/JSON/YAML.

### Endpoint CSV/JSON Import and Export
All three endpoint types support export (safe and sensitive modes) and bulk import. Import auto-creates `IPAddress` objects from plain strings and strips the `id` column to prevent cross-instance conflicts.

### Token Export Modal Improvements
The export-secrets modal now supports v1/v2 token formats via a selector and includes a **Quick Add** shortcut.

### Task History as a Sync Stage
Task history records from `proxbox-api` are now fetched and stored as part of the full sync pipeline.

### Retry on 5xx Backend Errors
Sync stages that receive a `5xx` response are automatically retried up to two times before being marked as failed.

### Run Now for Scheduled Jobs
Scheduled jobs in a terminal state now show a **Run now** button that immediately re-enqueues the same parameters on the high-priority RQ queue.

---

## Bug Fixes

| Area | Fix |
|------|-----|
| Security | Fixed IDOR in sensitive endpoint export — token lookup now scoped to requesting user |
| WebSocket | `websocket_port` now defaults to configured HTTP port instead of hardcoded `8800` |
| Backend handshake | `wait_for_backend_ready` passes on any HTTP `200` regardless of `init_ok` field |
| Backend handshake | Fail fast with clear log message when `proxbox-api` bootstrap is incomplete |
| API key push | Registers API key with backend before each `NetBoxEndpoint` push |
| RQ queue | `Run Now` uses high-priority queue for immediate pickup |
| Templates | Fixed `NoReverseMatch` — `core:job_rerun` → `core:job_proxbox_run` |
| Templates | Fixed `TemplateSyntaxError` — `hyperlinked_object` → `linkify` |
| Templates | Fixed schedule page `TemplateSyntaxError` that hid recurring jobs |
| Migrations | Fixed `pstart` migration cast error on PostgreSQL |
| Migrations | Lowered `dcim` migration dependency to support NetBox `4.5.0+` |
| Migrations | Added `state_operations` to squashed migration to remove stale `unique_together` |
| Models | Fixed Proxmox API type mismatches for `encrypted` and `pstart` fields |
| API serializers | `WritableNestedSerializer` for nested endpoint/cluster/node fields |
| API serializers | Added `display`, `tags`, `custom_fields`, `encryption_key` to settings serializer |
| API serializers | `select_related` chains added; fixed backup routine node URL N+1 |
| CSV import | Fixed id-column stripping override in `create_and_update_objects` |
| CSV import | Fixed circular import with lazy `sync_cluster_and_nodes` load |
| Reinstall | Run migrations in `reinstall.sh` to prevent missing-column HTTP 500 |

---

## Database Migrations

Migration `0022` (squashed) consolidates schema changes for this release cycle including `BackupRoutine`, extended `Replication` fields, `encryption_key` on settings, and removal of stale `unique_together` constraints.

```bash
python manage.py migrate netbox_proxbox
```

---

Full release notes: https://emersonfelipesp.github.io/netbox-proxbox/release-notes/version-0.0.11/

## Assets

No binary assets attached.

Source archives:

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