v4.1.1 - 2024-09-12

Enhancements

• #16926 - Add USB front & rear port types
• #17347 - Add NEMA L22-20 power port & outlet types

Bug Fixes

• #17066 - Fix OpenAPI schema definition for custom scripts REST API endpoint
• #17332 - Restore pagination for object list dashboard widgets
• #17333 - Avoid prefetching all jobs when retrieving custom scripts via the REST API
• #17353 - Fix styling of map buttons under site and device views
• #17354 - Prevent object & multi-object custom fields from breaking bulk import forms
• #17362 - Remove duplicate prefixes & IP addresses returned by the present_in_vrf query filter
• #17364 - Fix rendering of Markdown tables inside object list dashboard widgets
• #17387 - Fix display of the changelog tab for users with sufficient permission
• #17410 - Enable debug toolbar middleware for strawberry-django only when DEBUG is true
• #17414 - Fix support for declaring individual VLAN IDs within a VLAN group
• #17431 - Fix database migration error when upgrading to v4.1 from v3.7 or earlier
• #17437 - Fix exception when specifying a bridge relationship on an interface template
• #17444 - Custom script fails to execute when triggered by an event rule
• #17457 - GraphQL service_list filter should not require a port number

v4.1.0 - 2024-09-03

Breaking Changes

• Several filters deprecated in v4.0 have been removed (see #15410).
• The unit size for VirtualMachine.disk and VirtualDisk.size has been changed from 1 gigabyte to 1 megabyte. Existing values will be adjusted automatically during the upgrade process.
• The min_vid and max_vid fields on the VLAN group model have been replaced with vid_ranges, an array of starting and ending VLAN ID pairs.
• The five individual event type fields on the EventRule model have been replaced by a single event_types array field, which lists applicable event types by name.
• All UI views & API endpoints associated with change records have been moved from /extras to /core.
• The validate() method on CustomValidator subclasses now must accept the request argument (deprecated in v4.0 by #14279).

New Features

Circuit Groups (#7025)

Circuits can now be assigned to groups for administrative purposes. Each circuit may be assigned to multiple groups, and each assignment may optionally indicate a priority (primary, secondary, or tertiary).

VLAN Group ID Ranges (#9627)

The VLAN group model has been enhanced to support multiple VLAN ID (VID) ranges, whereas previously it could track only a single beginning and ending VID pair. VID ranges are stored as an array of beginning and ending (inclusive) integer pairs, e.g. 1-100,1000-1999.

Nested Device Modules (#10500)

Module bays can now be added to modules to effect a hierarchical arrangement of submodules within a device. A module installed within a device's module bay may itself have module bays into which child modules may be installed.

Rack Types (#12826)

A new rack type model has been introduced, which functions similarly to device types. Users can now define a common make and model of equipment rack, the attributes of which are automatically populated when creating a new rack of that type. Backward compatibility for racks with individually defined characteristics is fully retained.

Plugins Catalog Integration (#14731)

The NetBox UI now integrates directly with the canonical plugins catalog hosted by NetBox Labs. Users can now explore available plugins and check for newer releases natively within the NetBox user interface.

User Notifications (#15621)

NetBox now includes a user notification system. Users can subscribe to individual objects and be alerted to changes within the web interface. Additionally, event rules can be created to trigger notifications for specific users and/or groups. Plugins can also employ this notification system for their own purposes.

Enhancements

• #7537 - Add a serial number field for virtual machines
• #8198 - Enable uniqueness enforcement for custom field values
• #8984 - Enable filtering of custom script output by log level
• #11969 - Support for tracking airflow on racks and module types
• #14656 - Dynamically render the custom field edit form depending on the selected field type
• #15106 - Add distance and distance_unit fields for wireless links
• #15156 - Add display_url field to all REST API serializers, which links to the corresponding UI view for an object
• #16574 - Add last_synced time to REST API serializer for data sources
• #16580 - Enable plugin views to enforce LOGIN_REQUIRED selectively (remove AUTH_EXEMPT_PATHS)
• #16782 - Enable filtering of selection choices for object and multi-object custom fields
• #16907 - Update user interface styling
• #17051 - Introduce ISOLATED_DEPLOYMENT config parameter for denoting Internet isolation
• #17221 - ObjectEditView now supports HTMX-based object editing
• #17288 - Introduce a configurable limit on the number of aliases within a GraphQL API request
• #17289 - Enforce a standard policy for local passwords by default
• #17318 - Include the assigned provider in nested API representation of circuits

Bug Fixes (From Beta1)

• #17086 - Fix exception when viewing a job with no related object
• #17097 - Record static object representation when calling NotificationGroup.notify()
• #17098 - Prevent automatic deletion of related notifications when deleting an object
• #17159 - Correct file paths in plugin installation instructions
• #17163 - Fix filtering of related services under IP address view
• #17169 - Avoid duplicating catalog listings for installed plugins
• #17301 - Correct styling of the edit & delete buttons for custom script modules
• #17302 - Fix log level filtering support for custom script messages
• #17306 - Correct rounding of reported VLAN group utilization

Plugins

• #15692 - Introduce improved plugin support for background jobs
• #16359 - Enable plugins to embed content in the top navigation bar
• #16726 - Extend PluginTemplateExtension to enable registering multiple models
• #16776 - Add an alerts() method to PluginTemplateExtension for embedding important information on object views
• #16886 - Introduce a mechanism for plugins to register custom event types (for use with user notifications)

Other Changes

• #14692 - Change the atomic unit for virtual disks from 1GB to 1MB
• #14861 - The URL path for UI views concerning virtual disks has been standardized to /virtualization/virtual-disks/
• #15410 - Remove various deprecated query filters
• #15908 - Indicate product edition in release data
• #16388 - Move all change logging resources from extras to core
• #16884 - Remove the ID column from the default table configuration for changelog records
• #16988 - Relocate rack items in navigation menu
• #17143 - The use of legacy "nested" serializer classes has been deprecated

v4.0.11 - 2024-09-03

Bug Fixes

• #17310 - Enforce restricted queryset for related objects in GraphQL API requests
• #17321 - Ensure the job is attributed to the specified user when using the runscript management command
• #17323 - Associate job with script object when executed using the runscript management command
• #17337 - Fix ordering of virtual device contexts by device name
• #17341 - Avoid NoReverseMatch exceptions with specific dashboard widget configurations

v4.0.10 - 2024-08-29

Enhancements

• #16857 - Scroll long rendered Markdown content within tables
• #16905 - Enable filtering of device components by device status
• #16949 - Add device count column to sites table
• #17072 - Linkify email addresses & phone numbers in contact assignments list
• #17177 - Add facility field to locations filter form

Bug Fixes

• #16292 - Ensure consistent evaluation of queryset for both individual and list GraphQL API queries
• #16385 - Restore support for white, gray, and black background colors
• #16640 - Fix potential corruption of JSON values in custom fields that are not UI-editable
• #16670 - Fix conflicts within OpenAPI schema definition regarding nested serializers
• #16733 - Fix bulk edit/delete of objects when using "select all" widget
• #16756 - Fix dynamic pagination of custom script results table
• #16825 - Avoid NoReverseMatch exception when displaying count of related object type with no list view
• #16946 - GraphQL API requests with an invalid filter should return an empty set
• #16959 - Fix function of "reset" button on objects filter form
• #16973 - Fix support for evaluating user token ($user) against custom field values in permission constraints
• #17007 - Center SSO authentication icon when backend is unnamed
• #17070 - Image height & width values should not be required when creating an image attachment via the REST API
• #17108 - Ensure template date & time filters always return localtime-aware values
• #17117 - Work around Safari rendering bug
• #17186 - Fix display of custom links with default style under dark mode
• #17219 - Fix system config view exception when custom validator classes are employed
• #17230 - Ensure consistent rendering for all dashboard widget colors
• #17256 - Fix VLAN group scope selection for non-English languages
• #17278 - Ensure hierarchy is recalculated when bulk editing recursively nested object types (e.g. tenant groups)
• #17279 - Do not regenerate key when updating a token via REST API
• #17286 - Fix exception when adding member device to virtual chassis via web UI

v4.0.9 - 2024-08-14

Enhancements

• #16692 - Enable modifying VLAN assignment while bulk editing prefixes
• #17006 - Add IEEE 802.11be interface type

Bug Fixes

• #13459 - Correct OpenAPI schema type for TreeNodeMultipleChoiceFilter
• #16073 - Respect default values for custom fields during bulk import of objects
• #16176 - Restore ability to select multiple terminating devices when connecting a cable
• #16871 - Sanitize device ID query parameter when bulk editing components to prevent exception
• #17038 - Fix AttributeError exception when attempting to export system status data
• #17064 - Fix misaligned text within rendered Markdown code blocks
• #17124 - BaseTable should follow reverse one-to-one relationships when prefetching related objects
• #17131 - Fix exception when creating object-type custom field without selecting related object type
• #17144 - Avoid showing duplicated pop-up messages

v4.1-beta1 - 2024-08-05

Warning

This is a beta release of NetBox intended for testing and evaluation. Do not use this software in production. Also be aware that no upgrade path is provided to future releases.

Breaking Changes

• Several filters deprecated in v4.0 have been removed (see #15410).
• The unit size for VirtualMachine.disk and VirtualDisk.size been changed from 1 gigabyte to 1 megabyte. Existing values have been updated accordingly.
• The min_vid and max_vid fields on the VLAN group model have been replaced with vid_ranges, an array of starting and ending integer pairs.
• The five individual event type fields on the EventRule model have been replaced by a single event_types array field, indicating each assigned event type by name.
• The UI views & API endpoints associate with change records have been moved from /extras to /core.
• The validate() method on CustomValidator subclasses now must accept the request argument (deprecated in v4.0 by #14279).

New Features

Circuit Groups (#7025)

Circuits can now be assigned to groups for administrative purposes. Each circuit may be assigned to multiple groups, and each assignment may optionally indicate a priority (primary, secondary, or tertiary).

VLAN Group ID Ranges (#9627)

The VLAN group model has been enhanced to support multiple VLAN ID (VID) ranges, whereas previously it could track only a single beginning and ending VID. VID ranges are stored as an array of beginning and ending (inclusive) integer pairs.

Nested Device Modules (#10500)

Module bays can now be nested to effect a hierarchical arrangement of modules within a device. A module installed within a device's module bay may itself have module bays into which child modules may be installed.

Rack Types (#12826)

A new rack type model has been introduced, which functions similarly to the device type model. Users can now define a common make and model of rack, the attributes of which are automatically populated when creating a new rack of that type. Backward compatibility for racks with individually defined characteristics is fully retained.

Plugins Catalog Integration (#14731)

The NetBox UI now integrates directly with the canonical plugins catalog hosted by NetBox Labs. In addition to locally installed plugins, users can explore available plugins and check for newer releases.

User Notifications (#15621)

NetBox now includes a user notification system. Users can subscribe to individual objects and be alerted to changes live within the web interface. Additionally, event rules can now trigger notifications to specific users and/or groups. Plugins can also employ this notification system for their own purposes.

Enhancements

• #7537 - Add a serial number field for virtual machines
• #8198 - Enable uniqueness enforcement for custom field values
• #8984 - Enable filtering of custom script output by log level
• #11969 - Support for tracking airflow on racks and module types
• #14656 - Dynamically render custom field edit form depending on the selected field type
• #15106 - Add distance tracking for wireless links
• #15156 - Add display_url field to all REST API serializers
• #16580 - Enable individual views to enforce LOGIN_REQUIRED selectively (remove AUTH_EXEMPT_PATHS)
• #16782 - Enable filtering of selection choices for object type custom fields
• #16907 - Updated user interface styling
• #17051 - Introduced ISOLATED_DEPLOYMENT config parameter

Plugins

• #15692 - Introduce improved plugin support for background jobs
• #16359 - Enable plugins to embed content in the top navigation bar
• #16726 - Extend PluginTemplateExtension to enable registering multiple models
• #16776 - Added an alerts() method to PluginTemplateExtension for embedding important information about specific objects
• #16886 - Introduced a mechanism for plugins to register custom event types (for use with user notifications)

Other Changes

• #14692 - Change atomic unit for virtual disks from 1GB to 1MB
• #14861 - The URL path for UI views concerning virtual disks has been standardized to /virtualization/virtual-disks/
• #15410 - Removed various deprecated filters
• #15908 - Indicate product edition in release data
• #16388 - Move all change logging resources from extras to core
• #16884 - Remove the ID column from the default table configuration for changelog records
• #16988 - Relocated rack items in navigation menu

v4.0.8 - 2024-07-26

Enhancements

• #14640 - Add Dutch language support
• #14792 - Add Polish language support
• #15375 - Enable customization of SSO backend name & icon
• #15660 - Add Czech language support
• #15696 - Add Danish language support
• #16793 - Add Italian language support
• #16933 - Enable toggling true/false marks on BooleanColumn
• #16943 - Expand navigation breadcrumbs on job view to include the parent object

Bug Fixes

• #16357 - Replicate assigned type & tenant for cable when clicking "create an add another"
• #16402 - Remove inoperative links from report result view
• #16536 - Revert role & role_id filters for device components to device_role & device_role_id to avoid conflict with inventory item role field
• #16624 - Correct OpenAPI schema definitions for several fields
• #16760 - Fix data source syncing using git via a local path
• #16819 - Highlight parent device in rack when viewing child device
• #16838 - ActionsColumn should render extra buttons even when no stock actions are enabled
• #16867 - Fix exception when a dashboard list widget references a model which has been removed
• #16963 - Fix filtering of "accounts" link under providers list
• #16964 - Ensure configured password validators are enforced

v4.0.7 - 2024-07-09

Enhancements

• #14554 - Add support for django-storage-swift storage backend
• #16424 - Enable filtering of devices by cluster and cluster group
• #16716 - Display NAT address (if any) for OOB IP address under device view
• #16725 - Always position the admin section last in the navigation menu
• #16791 - Add 200 & 400 Gbps selections for circuit termination port speed
• #16802 - Introduce SENTRY_SEND_DEFAULT_PII configuration parameter and disable PII export by default
• #16817 - Add 200 & 400 Gbps selections for circuit commit rate

Bug Fixes

• #16523 - Restore highlighting of current device in virtual chassis members panel
• #16654 - Fix parent item assignment for inventory item bulk import
• #16657 - Fix translation of object types in global search
• #16679 - Avoid overwriting custom JSON fields during bulk edit
• #16689 - System configuration view should reflect static parameters when no config revisions exist
• #16714 - Fix cloning of device types with 0U height
• #16721 - Fix errant API request after deselecting a rack in device edit form
• #16723 - Fix escaping of path to virtual environment in upgrade.sh
• #16735 - Object list "results" tab should show a count of zero when empty
• #16747 - Avoid clearing entire search cache when manually reindexing specific apps/models
• #16758 - Ensure manually selected lagnuage persists across browser sessions
• #16779 - Fix saved filter selection for child object lists
• #16780 - IKE proposal created via REST API should not require authentication_algorithm
• #16796 - Allow assignment of VM with no site to a cluster with a site
• #16806 - Fix redirect URL when creating contact assignments with "add another" button
• #16807 - Fix layout of VLAN edit form when custom fields are present
• #16808 - Fix event rule triggering in scenario where objects are updated immediately prior to deletion
• #16813 - Fix AttributeError exception when filtering bookmarks in dashboard widget by object type
• #16843 - Permit creation of IKE policies via REST API without specifying an IKE mode

v4.0.6 - 2024-06-24

Enhancements

• #15348 - Show saved filters alongside quick search on object list views
• #15794 - Dynamically populate related objects in UI views
• #16256 - Enable alphabetical ordering of bookmarks on dashboard
• #16307 - Enable calling log_*() methods on Script without passing a message

Bug Fixes

• #13925 - Fix support for "zulu" (UTC) timestamps for custom fields
• #14829 - Fix support for simple conditions (without AND/OR) in event rules
• #15717 - Allow assigning a device/VM in a site to a cluster with no site assigned
• #16143 - Display timestamps in tables in the configured timezone
• #16149 - Fix object linking in custom script logs
• #16252 - Fix total count in tab at top of rack elevations view
• #16273 - Restore global search bar on mobile
• #16416 - Retain dark/light mode toggle on mobile view
• #16444 - Disable ordering circuits list by A/Z termination
• #16450 - Searching for rack unit in form dropdown should be case-insensitive
• #16452 - Fix sizing of buttons within object attribute panels
• #16454 - Address DNS lookup bug in django-debug-toolbar
• #16460 - Omit spaces from telephone number URLs
• #16512 - Restore a user's preferred language (if any) on login
• #16542 - Fix bulk form operations when HTMX is enabled
• #16702 - Fix validation of return_url query parameter

v4.0.5 - 2024-06-06

Enhancements

• #14810 - Enable contact assignment for services
• #15489 - Add 1000Base-TX interface type
• #15873 - Improve readability of allocates resource numbers for clusters
• #16290 - Capture entire object in changelog data (but continue to display only non-internal attributes)
• #16353 - Enable plugins to extend object change view with custom content

Bug Fixes

• #13422 - Rebuild MPTT trees for applicable models after merging staged changes
• #14567 - Apply active quicksearch value when exporting "current view" from object list
• #15194 - Avoid enqueuing duplicate event triggers for a modified object
• #16039 - Fix row highlighting for front & rear port connections under device view
• #16050 - Fix display of names & descriptions defined for custom scripts
• #16083 - Disable font ligatures to avoid peculiarities in rendered text
• #16202 - Fix site map button URL for certain localizations
• #16261 - Fix GraphQL filtering for certain multi-value filters
• #16286 - Fix global search support for provider accounts
• #16312 - Fix object list navigation for dashboard widgets
• #16315 - Fix filtering change log & journal entries by object type in UI
• #16376 - Update change log for the terminating object (e.g. interface) when attaching a cable
• #16400 - Fix AttributeError when attempting to restore a previous configuration revision after deleting the current one