Skip to content

NetBox v3.6

v3.6.9 (2023-12-28)

Enhancements

  • #14631 - All models can be filtered and searched by their description field (where applicable)

Bug Fixes

  • #14482 - Fix validation error when attempting to move a primary IP address to a new parent object
  • #14620 - Permit setting device type U height to 0 during bulk edit
  • #14621 - Fix error when using the device search filter

v3.6.8 (2023-12-27)

Enhancements

  • #11039 - List parent prefixes under IP range view
  • #14507 - Print new NetBox version when running upgrade script
  • #14538 - Add the available_at_site filter for VLANs
  • #14596 - Match against description field when searching for devices

Bug Fixes

  • #11816 - Correct display of error message when attempting invalid VLAN site & group assignment
  • #12731 - Fix custom validation for many-to-many fields
  • #13606 - Fix filtering custom multi-choice fields by null
  • #13649 - Correct calculation of absolute lengths for zero-length cables
  • #13812 - Update status of remote data source when syncing fails via syncdatasource management command
  • #13909 - Fix cloning of objects which have a multi-choice custom field
  • #14517 - Ensure reservations tab is always displayed under rack view
  • #14532 - Device/VM change record should accurately reflect when primary/OOB IP is deleted
  • #14549 - Fix association of job results when executing scripts via runscript management command
  • #14560 - Do not escape exclamation marks in custom link URLs
  • #14575 - Fix display of the tags column under VDC table
  • #14613 - Fix display of current configuration parameters in UI

v3.6.7 (2023-12-15)

Enhancements

  • #12751 - Designate fields to expand by default for object selector widget
  • #14148 - Add tags column to L2VPN terminations column
  • #14390 - Add classes parameter to copy_content template tag
  • #14467 - Change custom field choice delimiter from comma to colon

Bug Fixes

  • #13983 - Fix bulk import support for custom field choices
  • #14081 - Ensure accuracy of parent object counters when deleting related objects
  • #14249 - Fix server error when authenticating via IP-restricted API tokens using IPv6
  • #14392 - Fix bulk operations for plugin models under admin UI
  • #14397 - Fix exception on non-JSON request to /available-ips/ API endpoints
  • #14401 - Rack starting_unit cannot be zero
  • #14432 - Populate custom field default values for components when creating a device
  • #14448 - Fix exception when creating a power feed with rack and panel in different sites
  • #14505 - Fix the assignment of tags to L2VPN terminations
  • #14512 - Remove unneeded annotations from queries when using REST API brief mode
  • #14515 - Ensure user config is created automatically for all user accounts
  • #14522 - Fix filtering contact assignments by group
  • #14533 - Fix quick search under VLAN group VLANs list

v3.6.6 (2023-11-29)

Enhancements

  • #13735 - Show complete region hierarchy in UI for all relevant objects

Bug Fixes

  • #14056 - Record a pre-change snapshot when bulk editing objects via CSV
  • #14187 - Raise a validation error when attempting to create a duplicate script or report
  • #14199 - Fix jobs list for reports with a custom name
  • #14239 - Fix CustomFieldChoiceSet search filter
  • #14242 - Enable export templates for contact assignments
  • #14299 - Webhook timestamps should be in proper ISO 8601 format
  • #14325 - Fix numeric ordering of service ports
  • #14339 - Correctly hash local user password when set via REST API
  • #14343 - Fix ordering ASN table by ASDOT column
  • #14346 - Fix running reports via REST API
  • #14349 - Fix custom validation support for remote data sources
  • #14363 - Fix bulk editing of interfaces assigned to VM with no cluster

v3.6.5 (2023-11-09)

Enhancements

  • #12741 - Add selector widget to platform field on device & virtual machine forms
  • #13022 - Introduce support for assigning IP addresses when bulk importing services
  • #13587 - Annotate units of measurement on power port table columns
  • #13669 - Add bulk import button to contact assignments list view
  • #13723 - Add inventory items column to interfaces table
  • #13743 - Add site column to power feeds table
  • #13936 - Add primary IPv4 and IPv6 filters for virtual machines and VDCs
  • #13951 - Add device & virtual machine fields to service filter form
  • #14085 - Strip trailing port number from value returned by get_client_ip()
  • #14101 - Add greater/less than mask length filters for IP addresses
  • #14112 - Add tab listing child items under inventory item view
  • #14113 - Add optional parent column to inventory items table
  • #14220 - Order available columns alphabetically in table configuration form
  • #14221 - Add contact group column on contact assignments table

Bug Fixes

  • #14033 - Avoid exception when attempting to connect both ends of a cable to the same object
  • #14117 - Check that enough rear port positions have been selected to accommodate the number of front ports being created
  • #14166 - Permit user login when maintenance mode is enabled
  • #14182 - Ensure the active configuration is restored upon clearing cache
  • #14195 - Correct permissions evaluation for ASN range child ASNs view
  • #14223 - Disable ordering of jobs by assigned object

v3.6.4 (2023-10-17)

Enhancements

  • #12831 - Include circuit description in cable trace SVG image
  • #12872 - Introduce the DATA_UPLOAD_MAX_MEMORY_SIZE configuration parameter
  • #13950 - Display custom choice field labels rather than values in UI
  • #13957 - Add DNS name filter on IP addresses list
  • #13962 - Add a copy-to-clipboard button for API tokens
  • #13972 - Introduce a filter to find unterminated cables

Bug Fixes

  • #11987 - Fix validation of bulk cable updates via bulk import form
  • #12328 - Ensure generic foreign key relationships are populated in REST API serializations of objects
  • #12336 - Employ PostgreSQL advisory locks to avoid duplicate MPTT tree IDs when bulk creating objects
  • #13064 - Fix resetting of checkbox fields triggered by HTMX form re-rendering
  • #13440 - Fix support for assigning a tenant when creating "next available" VLANs via the REST API
  • #13746 - Fix support for setting custom field values when creating "next available" IP addresses via the REST API
  • #13872 - Add CSV delimiter field to file upload tab under bulk object upload views
  • #13876 - Fix support for assigning an interface when creating "next available" IP addresses via the REST API
  • #13910 - Correct "add device" button link under platform view
  • #13944 - Correct serialization of several report attributes in the REST API
  • #13966 - Restore "last login" column on users table
  • #14013 - Fix device role filter choices under inventory items list filters
  • #14023 - Fix exception when bulk disconnecting interfaces connected to the same cable
  • #14025 - Fix exception when viewing a script that begins with the same name as another
  • #14026 - Optimize the automatic creation of available IP addresses for large prefixes
  • #14042 - Fix duplicated child object count decrements when removing objects in bulk

v3.6.3 (2023-09-26)

Enhancements

  • #12732 - Add toggle to hide disconnected interfaces under device view

Bug Fixes

  • #11079 - Enable tracing cable paths across multiple cables in parallel
  • #11901 - Fix IndexError exception when manipulating terminations for existing cables via REST API
  • #13506 - Enable creating a config template which references a data file via the REST API
  • #13666 - Cleanly handle reports without any test methods defined
  • #13839 - Restore original text color for HTML code elements
  • #13843 - Fix assignment of VLAN group scope during bulk edit
  • #13845 - Fix AttributeError exception when attaching front/rear images to a device type
  • #13849 - Fix KeyError exception when deleting an object which references a configured choice value that has been removed
  • #13859 - Fix invalid response when searching for custom choice field values returns no matches
  • #13864 - Correct default background color for dashboard widget headers
  • #13871 - Fix rack filtering for empty location during device bulk import
  • #13891 - Allow designating an IP address as primary for device/VM while assigning it to an interface

v3.6.2 (2023-09-20)

Enhancements

  • #13245 - Add interface types for QSFP112 and OSFP-RHS
  • #13563 - Add support for other delimiting characters when using CSV import

Bug Fixes

  • #11209 - Hide available IP/VLAN listing when sorting under a parent prefix or VLAN range
  • #11617 - Raise validation error on the presence of an unknown CSV header during bulk import
  • #12219 - Fix dashboard widget heading contrast under dark mode
  • #12685 - Render Markdown in custom field help text on object edit forms
  • #13653 - Tweak color of error text to improve legibility
  • #13701 - Correct display of power feed legs under device view
  • #13706 - Restore extra filters dropdown on device interfaces list
  • #13721 - Filter VLAN choices by selected site (if any) when creating a prefix
  • #13727 - Fix exception when viewing rendered config for VM without a role assigned
  • #13745 - Optimize counter field migrations for large databases
  • #13756 - Fix exception when sorting module bay list by installed module status
  • #13757 - Fix RecursionError exception when assigning config context to a device type
  • #13767 - Fix support for comments when creating a new service via web UI
  • #13782 - Fix tag exclusion support for contact assignments
  • #13791 - Preserve whitespace in values when performing bulk rename of objects via web UI
  • #13809 - Avoid TypeError exception when editing active configuration with statically defined CUSTOM_VALIDATORS
  • #13813 - Fix member count for newly created virtual chassis
  • #13818 - Restore missing tags field on L2VPN termination edit form

v3.6.1 (2023-09-06)

Enhancements

  • #12870 - Support setting token expiration time using the provisioning API endpoint
  • #13444 - Add bulk rename functionality to the global device component lists
  • #13638 - Add optional staff_only attribute to MenuItem

Bug Fixes

  • #12553 - Ensure family attribute is always returned when creating aggregates and prefixes via REST API
  • #13619 - Fix exception when viewing IP address assigned to a virtual machine
  • #13596 - Always display "render config" tab for devices and virtual machines
  • #13620 - Show admin menu items only for staff users
  • #13622 - Fix exception when viewing current config and no revisions have been created
  • #13626 - Correct filtering of recent activity list under user view
  • #13628 - Remove stale references to obsolete NAPALM integration
  • #13630 - Fix display of active status under user view
  • #13632 - Avoid raising exception when checking if FHRP group IP address is primary
  • #13642 - Suppress warning about unreflected model changes when applying migrations
  • #13657 - Fix decoding of data file content
  • #13674 - Fix retrieving individual report via REST API
  • #13682 - Fix error message returned when validation of custom field default value fails
  • #13684 - Enable modifying the configuration when maintenance mode is enabled

v3.6.0 (2023-08-30)

Breaking Changes

  • PostgreSQL 11 is no longer supported (dropped in Django 4.2). NetBox v3.6 requires PostgreSQL 12 or later.
  • The boto3 and dulwich packages are no longer installed automatically. If needed for S3/git remote data backend support, add them to local_requirements.txt to ensure their installation.
  • The device_role field on the Device model has been renamed to role. The device_role field has been temporarily retained on the REST API serializer for devices for backward compatibility, but is read-only.
  • The choices array field has been removed from the CustomField model. Any defined choices are automatically migrated to CustomFieldChoiceSets, accessible via the new choice_set field on the CustomField model.
  • The napalm_driver and napalm_args fields (which were deprecated in v3.5) have been removed from the Platform model.
  • The device and device_id filter for interfaces will no longer include interfaces from virtual chassis peers. Two new filters, virtual_chassis_member and virtual_chassis_member_id, have been introduced to match all interfaces belonging to the specified device's virtual chassis (if any).
  • Reports and scripts are now returned within a results list when fetched via the REST API, consistent with other models.
  • Superusers can no longer retrieve API token keys via the web UI if ALLOW_TOKEN_RETRIEVAL is disabled. (The admin view has been removed per #13044.)

New Features

Relocated Admin UI Views (#12589, #12590, #12591, #13044)

Management views for the following object types, previously available only under the backend admin interface, have been relocated to the primary user interface:

  • Users
  • Groups
  • Object permissions
  • API tokens
  • Configuration revisions

This migration provides a more consistent user experience and unlocks advanced functionality not feasible using Django's built-in views. The admin UI is scheduled for complete removal in NetBox v4.0.

Configurable Default Permissions (#13038)

Administrators now have the option of configuring default permissions for all users globally, regardless of explicit permission or group assignments granted in the database. This is accomplished by defining the DEFAULT_PERMISSIONS configuration parameter. By default, all users are granted permission to manage their own bookmarks and API tokens.

User Bookmarks (#8248)

Users can now bookmark their favorite objects in NetBox. Bookmarks are accessible under each user's personal bookmarks list, and can also be added as a dashboard widget.

Custom Field Choice Sets (#12988)

Selection and multi-select custom fields now employ discrete, reusable choice sets containing the valid options for each field. A choice set may be shared by multiple custom fields. Additionally, each choice within a set can now specify both a raw value and a human-friendly label (see #13241). Pre-existing custom field choices are migrated to choice sets automatically during the upgrade process.

Pre-Defined Location Choices for Custom Fields (#12194)

Users now have the option to employ one of several pre-defined sets of choices when creating a custom field. These include:

  • IATA airport codes
  • ISO 3166 country codes
  • UN/LOCODE location identifiers

When defining a choice set, one of the above can be employed as the base set, with the option to define extra, custom choices as well.

Restrict Tag Usage by Object Type (#11541)

Tags may now be restricted to use with designated object types. Tags that have no specific object types assigned may be used with any object that supports tag assignment.

Enhancements

  • #6347 - Cache the number of assigned components for devices and virtual machines
  • #8137 - Add a field for designating the out-of-band (OOB) IP address for devices
  • #10197 - Cache the number of member devices on each virtual chassis
  • #11305 - Add GPS coordinate fields to the device model
  • #11478 - Introduce virtual_chassis_member filter for interfaces & restore default behavior for device filter
  • #11519 - Add a SQL index for IP address host values to optimize queries
  • #11732 - Prevent inadvertent overwriting of object attributes by competing users
  • #11936 - Introduce support for tags and custom fields on webhooks
  • #12175 - Permit racks to start numbering at values greater than one
  • #12210 - Add tenancy assignment for power feeds
  • #12461 - Add config template rendering for virtual machines
  • #12814 - Expose NetBox models within ConfigTemplate rendering context
  • #12882 - Add tag support for contact assignments
  • #13037 - Return reports & scripts within a results list when fetched via the REST API
  • #13170 - Add rf_role to InterfaceTemplate
  • #13269 - Cache the number of assigned component templates for device types

Bug Fixes

  • #13513 - Prevent exception when rendering bookmarks widget for anonymous user
  • #13599 - Fix errant counter increments when editing device/VM components
  • #13605 - Optimize cached counter migrations to avoid excessive memory consumption

Other Changes

  • Work has begun on introducing translation and localization support in NetBox. This work is being performed in preparation for release 4.0.
  • #6391 - Rename the device_role field on Device to role for consistency with VirtualMachine
  • #9077 - Prevent the errant execution of dangerous instance methods in Django templates
  • #11766 - Remove obsolete custom ChoiceField and MultipleChoiceField classes
  • #12180 - All API endpoints for available objects (e.g. IP addresses) now inherit from a common parent view
  • #12237 - Upgrade Django to v4.2
  • #12320 - Remove obsolete fields napalm_driver and napalm_args from Platform
  • #12794 - Avoid direct imports of Django's stock user model
  • #12906 - The boto3 (AWS) and dulwich (git) packages for remote data sources are now optional requirements
  • #12964 - Drop support for PostgreSQL 11
  • #13309 - User account-specific resources have been moved to a new account app for better organization

REST API Changes

  • Introduced the following endpoints:
    • /api/extras/bookmarks/
    • /api/extras/custom-field-choice-sets/
  • Added the /api/extras/custom-fields/{id}/choices/ endpoint for select and multi-select custom fields
  • dcim.Device
    • Renamed device_role to device. Added a read-only device_role field for limited backward compatibility.
    • Added the latitude and longitude fields (for GPS coordinates)
    • Added the oob_ip field for out-of-band IP address assignment
  • dcim.DeviceType
    • Added read-only counter fields for assigned component templates:
      • console_port_template_count
      • console_server_port_template_count
      • power_port_template_count
      • power_outlet_template_count
      • interface_template_count
      • front_port_template_count
      • rear_port_template_count
      • device_bay_template_count
      • module_bay_template_count
      • inventory_item_template_count
  • dcim.InterfaceTemplate
    • Added the rf_role field
  • dcim.Platform
    • Removed the napalm_driver and napalm_args fields
  • dcim.PowerFeed
    • Added the tenant field
  • dcim.Rack
    • Added the starting_unit field
  • dcim.VirtualChassis
    • Added the read-only member_count field
  • extras.CustomField
    • Removed the choices array field
    • Added the choice_set foreign key field (to ChoiceSet)
  • extras.Report
    • Reports are now returned within a results list
  • extras.Script
    • Scripts are now returned within a results list
  • extras.Tag
    • Added the object_types field for optional restriction to specific object types
  • extras.Webhook
    • Added custom_fields and tags support
  • tenancy.ContactAssignment
    • Added tags support
  • virtualization.VirtualMachine
    • Added the oob_ip field for out-of-band IP address assignment