Skip to content

NetBox v3.3

v3.3.10 (2022-12-13)

Enhancements

  • #9361 - Add replication controls for module bulk import
  • #10255 - Introduce LOGOUT_REDIRECT_URL config parameter to control redirection of user after logout
  • #10447 - Enable reassigning an inventory item from one device to another
  • #10516 - Add vertical frame & cabinet rack types
  • #10748 - Add provider selection field for provider networks to circuit termination edit view
  • #11089 - Permit whitespace in MAC addresses
  • #11119 - Enable filtering L2VPNs by slug

Bug Fixes

  • #11041 - Correct power utilization percentage precision
  • #11077 - Honor configured date format when displaying date custom field values in tables
  • #11087 - Fix background color of bottom banner content
  • #11101 - Correct circuits count under site view
  • #11109 - Fix nullification of custom object & multi-object fields via REST API
  • #11128 - Disable ordering changelog table by object to avoid exception
  • #11142 - Correct available choices for status under IP range filter form
  • #11168 - Honor RQ_DEFAULT_TIMEOUT config parameter when using Redis Sentinel
  • #11173 - Enable missing tags columns for contact, L2VPN lists

v3.3.9 (2022-11-30)

Enhancements

  • #10653 - Ensure logging of failed login attempts

Bug Fixes

  • #6389 - Call snapshot() on object when processing deletions
  • #9223 - Fix serialization of array field values in change log
  • #9878 - Fix spurious error message when rendering REST API docs
  • #10236 - Fix TypeError exception when viewing PDU configured for three-phase power
  • #10241 - Support referencing custom field related objects by attribute in addition to PK
  • #10579 - Mark cable traces terminating to a provider network as complete
  • #10721 - Disable ordering by custom object field columns
  • #10929 - Raise validation error when attempting to create a duplicate cable termination
  • #10936 - Permit demotion of device/VM primary IP via IP address edit form
  • #10938 - render_field template tag should respect label kwarg
  • #10969 - Update cable paths ending at associated rear port when creating new front ports
  • #10996 - Hide checkboxes on child object lists when no bulk operations are available
  • #10997 - Fix exception when editing NAT IP for VM with no cluster
  • #11014 - Use natural ordering when sorting rack elevations by name
  • #11028 - Enable bulk clearing of color attribute of pass-through ports
  • #11047 - Cloning a rack reservation should replicate rack & user

v3.3.8 (2022-11-16)

Enhancements

  • #10356 - Add backplane Ethernet interface types
  • #10902 - Add location selector to power feed form
  • #10904 - Use front/rear port colors in cable trace SVG
  • #10914 - Include "add module type" button on manufacturer view
  • #10915 - Add count of L2VPNs to tenant view
  • #10919 - Include device location under cable view
  • #10920 - Include request cookies when queuing a custom script

Bug Fixes

  • #9439 - Ensure thread safety of change logging functions
  • #10709 - Correct UI display for azuread-v2-tenant-oauth2 SSO backend
  • #10829 - Fix bulk edit/delete buttons ad top of object lists
  • #10837 - Correct cookie paths when BASE_PATH is set
  • #10874 - Remove erroneous link for contact assignment count
  • #10881 - Fix dark mode coloring for data on device status page
  • #10891 - Populate tag selection list for service filter form
  • #10897 - Fix form widget styling on FHRP group form
  • #10910 - Fix cable creation links on power port view

v3.3.7 (2022-11-01)

Bug Fixes

  • #10282 - Enforce advisory locks when allocating available IP addresses to prevent race conditions
  • #10770 - Fix social authentication for new users
  • #10791 - Permit nullifying VLAN group scope_type via REST API
  • #10803 - Fix exception when ordering contacts by number of assignments
  • #10809 - Permit nullifying site time_zone via REST API

v3.3.6 (2022-10-26)

Enhancements

  • #9584 - Enable filtering devices by device type slug
  • #9722 - Add LDAP configuration parameters to specify certificates
  • #10580 - Link "assigned" checkbox in IP address table to assigned interface
  • #10639 - Set cookie paths according to configured BASE_PATH
  • #10685 - Position A/Z termination cards above the fold under circuit view

Bug Fixes

  • #9669 - Strip colons from usernames when using remote authentication
  • #10575 - Include OIDC dependencies for python-social-auth
  • #10584 - Fix service clone link
  • #10610 - Allow assignment of VC member to LAG on non-master peer
  • #10643 - Ensure consistent display of custom fields for all model forms
  • #10646 - Fix filtering of power feed by power panel when connecting a cable
  • #10655 - Correct display of assigned contacts in object tables
  • #10666 - Re-evaluate disabled LDAP user when processing API requests
  • #10682 - Correct home view links to connection lists
  • #10712 - Fix ModuleNotFoundError exception when generating API schema under Python 3.9+
  • #10716 - Add left/right page plugin content embeds for tag view
  • #10719 - Prevent user without sufficient permission from creating an IP address via FHRP group creation
  • #10723 - Distinguish between inside/outside NAT assignments for device/VM primary IPs
  • #10745 - Correct display of status field in clusters list
  • #10746 - Add missing status attribute to cluster view

v3.3.5 (2022-10-05)

Enhancements

  • #8424 - Include rack elevation under device view
  • #10352 - Omit extraneous URL query attributes during search
  • #10465 - Improve formatting of device heights and rack positions

Bug Fixes

  • #9497 - Adjust non-racked device filter on site and location detailed view
  • #10408 - Fix validation when attempting to add redundant contact assignments
  • #10423 - Enforce object type validation when creating journal entries
  • #10435 - Fix exception when filtering VLANs by virtual machine with no cluster assigned
  • #10439 - Fix form widget styling for DeviceType airflow field
  • #10445 - Avoid rounding virtual machine memory values
  • #10460 - Restore missing connection details for device components
  • #10461 - Enable filtering by read-only custom fields in the UI
  • #10470 - Omit read-only custom fields from CSV import forms
  • #10480 - Cable trace SVG links should not force a new window
  • #10491 - Clarify representation of blocking contact assignments during contact deletion
  • #10513 - Disable the reassignment of a module to a new device
  • #10517 - Automatically inherit site assignment from cluster when creating a virtual machine
  • #10559 - Permit the pinning of a VM to a particular device within a cluster which has no site assignment
  • #10562 - Correct URL for contacts table tags column

v3.3.4 (2022-09-16)

Bug Fixes

  • #10383 - Fix assignment of component templates to module types via web UI
  • #10387 - Fix MultiValueDictKeyError exception when editing a device interface

v3.3.3 (2022-09-15)

Enhancements

  • #8580 - Add occupied filter for cabled objects to filter by cable or mark_connected
  • #9577 - Add has_front_image and has_rear_image filters for device types
  • #10268 - Omit trailing ".0" in device positions within UI
  • #10359 - Add region and site group columns to the devices table

Bug Fixes

  • #9231 - Fix empty lookup expression for string filters
  • #10247 - Allow changing the pre-populated device/VM when creating new components
  • #10250 - Fix exception when CableTermination validation fails during bulk import of cables
  • #10258 - Enable the use of reports & scripts packaged in submodules
  • #10259 - Fix NoReverseMatch exception when listing available prefixes with "flat" column displayed
  • #10270 - Fix custom field validation when creating new services
  • #10278 - Fix "create & add another" for image attachments
  • #10294 - Fix spurious changelog diff for interface WWN field
  • #10304 - Enable cloning for custom fields & custom links
  • #10305 - Fix Virtual Chassis master field cannot be null according to the API
  • #10307 - Correct value for "Passive 48V (4-pair)" PoE type selection
  • #10333 - Show available values for ui_visibility field of CustomField for CSV import
  • #10337 - Display SSO links when local authentication fails
  • #10353 - Table action buttons should reserve return URL parameters
  • #10362 - Correct display of custom fields when editing an L2VPN termination

v3.3.2 (2022-09-02)

Enhancements

  • #9477 - Enable clearing applied table column ordering
  • #10034 - Add L2VPN column to interface and VLAN tables
  • #10043 - Add support for limit query parameter to available VLANs API endpoint
  • #10060 - Add journal entries to global search
  • #10195 - Enable filtering of device components by rack
  • #10233 - Enable sorting rack elevations by facility ID

Bug Fixes

  • #9328 - Hide available IPs when non-default ordering is applied
  • #9481 - Update child device location when parent location changes
  • #9832 - Improve error message when validating rack reservation units
  • #9895 - Various corrections to OpenAPI spec
  • #9962 - SSO login should respect next URL query parameter
  • #9963 - Fix support for custom CSRF_COOKIE_NAME value
  • #10155 - Fix rear port display when editing front port template for module type
  • #10156 - Avoid forcing SVG image links to open in a new window
  • #10161 - Restore "set null" option for custom fields during bulk edit
  • #10176 - Correct utilization display for empty racks
  • #10177 - Correct display of custom fields when editing VM interfaces
  • #10178 - Display manufacturer name alongside device type under device view
  • #10181 - Restore MultiPartParser (regression from #10031)
  • #10184 - Fix vertical alignment when displaying object attributes with buttons
  • #10208 - Fix permissions evaluation for interface actions dropdown menu
  • #10217 - Handle exception when trace splits to multiple rear ports
  • #10220 - Validate IP version when assigning primary IPs to a virtual machine
  • #10231 - Correct API schema definition for several serializer fields

v3.3.1 (2022-08-25)

Enhancements

  • #6454 - Include contextual help when creating first objects in UI
  • #9935 - Add 802.11ay and "other" wireless interface types
  • #10031 - Enforce application/json content type for REST API requests
  • #10033 - Disable "add termination" button for point-to-point L2VPNs with two terminations
  • #10037 - Add "child interface" option to actions dropdown in interfaces list
  • #10038 - Add "L2VPN termination" option to actions dropdown in interfaces list
  • #10039 - Add "assign FHRP group" option to actions dropdown in interfaces list
  • #10061 - Replicate type when cloning L2VPN instances
  • #10066 - Use fixed column widths for custom field values in UI
  • #10133 - Enable nullifying device location during bulk edit

Bug Fixes

  • #9663 - Omit available IP annotations when filtering prefix child IPs list
  • #10040 - Fix exception when ordering prefixes by flat representation
  • #10053 - Custom fields header should not be displayed when editing circuit terminations with no custom fields
  • #10055 - Fix extraneous NAT indicator by device primary IP
  • #10057 - Fix AttributeError exception when global search results include rack reservations
  • #10059 - Add identifier column to L2VPN table
  • #10070 - Add unique constraint for L2VPN slug
  • #10087 - Correct display of far end in console/power/interface connections tables
  • #10089 - linkify template filter should escape object representation
  • #10094 - Fix 404 when using "create and add another" to add contact assignments
  • #10108 - Linkify inside NAT IPs for primary device IPs in UI
  • #10109 - Fix available prefixes calculation for container prefixes in the global table
  • #10111 - Fix ValueError exception when searching for L2VPN objects
  • #10118 - Fix display of connected LLDP neighbors for devices
  • #10134 - Custom fields data serializer should return a 400 response for invalid data
  • #10135 - Fix SSO support for SAML2 IDPs
  • #10147 - Permit the creation of 0U device types via REST API

v3.3.0 (2022-08-17)

Breaking Changes

  • Device position, device type height, and rack unit values are now reported as decimals (e.g. 1.0 or 1.5) to support modeling half-height rack units.
  • The nat_outside relation on the IP address model now returns a list of zero or more related IP addresses, rather than a single instance (or None).
  • Several fields on the cable API serializers have been altered or removed to support multiple-object cable terminations:
Old Name Old Type New Name New Type
termination_a_type string Removed -
termination_b_type string Removed -
termination_a_id integer Removed -
termination_b_id integer Removed -
termination_a object a_terminations list
termination_b object b_terminations list
  • As with the cable model, several API fields on all objects to which cables can be connected (interfaces, circuit terminations, etc.) have been changed:
Old Name Old Type New Name New Type
link_peer object link_peers list
link_peer_type string link_peers_type string
connected_endpoint object connected_endpoints list
connected_endpoint_type string connected_endpoints_type string
connected_endpoint_reachable boolean connected_endpoints_reachable boolean
  • The cable path serialization returned by the /paths/ endpoint for pass-through ports has been simplified, and the following fields removed: origin_type, origin, destination_type, destination. (Additionally, is_complete has been added.)

New Features

Multi-object Cable Terminations (#9102)

When creating a cable in NetBox, each end can now be attached to multiple termination points. This allows accurate modeling of duplex fiber connections to individual termination ports and breakout cables, for example. (Note that all terminations attached to one end of a cable must be the same object type, but do not need to connect to the same parent object.) Additionally, cable terminations can now be modified without needing to delete and recreate the cable.

L2VPN Modeling (#8157)

NetBox can now model a variety of L2 VPN technologies, including VXLAN, VPLS, and others. Interfaces and VLANs can be attached to L2VPNs to track connectivity across an overlay. Similarly to VRFs, each L2VPN can also have import and export route targets associated with it.

PoE Interface Attributes (#1099)

Two new fields have been added to the device interface model to track Power over Ethernet (PoE) capabilities:

  • PoE mode: Power supplying equipment (PSE) or powered device (PD)
  • PoE type: Applicable IEEE standard or other power type

Half-Height Rack Units (#51)

Device type height can now be specified in 0.5U increments, allowing for the creation of devices consume partial rack units. Additionally, a device can be installed at the half-unit mark within a rack (e.g. U2.5). For example, two half-height devices positioned in sequence will consume a single rack unit; two consecutive 1.5U devices will consume 3U of space.

Restrict API Tokens by Client IP (#8233)

API tokens can now be restricted to use by certain client IP addresses or networks. For example, an API token with its allowed_ips list set to [192.0.2.0/24] will permit authentication only from API clients within that network; requests from other sources will fail authentication. This enables administrators to restrict the use of a token to specific clients.

Reference User in Permission Constraints (#9074)

NetBox's permission constraints have been expanded to support referencing the current user associated with a request using the special $user token. As an example, this enables an administrator to efficiently grant each user to edit his or her own journal entries, but not those created by other users.

{
  "created_by": "$user"
}

Custom Field Grouping (#8495)

A group_name field has been added to the custom field model to enable organizing related custom fields by group. Similarly to custom links, custom fields which have been assigned to the same group will be rendered within that group when viewing an object in the UI. (Custom field grouping has no effect on API operation.)

Toggle Custom Field Visibility (#9166)

The behavior of each custom field within the NetBox UI can now be controlled individually by toggling its UI visibility. Three options are available:

  • Read/write: The custom field is included when viewing and editing objects (default).
  • Read-only: The custom field is displayed when viewing an object, but it cannot be edited via the UI. (It will appear in the form as a read-only field.)
  • Hidden: The custom field will never be displayed within the UI. This option is recommended for fields which are not intended for use by human users.

Custom field UI visibility has no impact on API operation.

Enhancements

  • #1202 - Support overlapping assignment of NAT IP addresses
  • #4350 - Illustrate reservations vertically alongside rack elevations
  • #4434 - Enable highlighting devices within rack elevations
  • #5303 - A virtual machine may be assigned to a site and/or cluster
  • #7120 - Add termination_date field to Circuit
  • #7744 - Add status field to Location
  • #8171 - Populate next available address when cloning an IP
  • #8222 - Enable the assignment of a VM to a specific host device within a cluster
  • #8471 - Add status field to Cluster
  • #8511 - Enable custom fields and tags for circuit terminations
  • #8995 - Enable arbitrary ordering of REST API results
  • #9070 - Hide navigation menu items based on user permissions
  • #9177 - Add tenant assignment for wireless LANs & links
  • #9391 - Remove 500-character limit for custom link text & URL fields
  • #9536 - Track API token usage times
  • #9582 - Enable assigning config contexts based on device location

Bug Fixes (from Beta2)

  • #9758 - Display parent object of connected termination
  • #9900 - Pre-populate site & rack fields for cable connection form
  • #9938 - Exclude virtual interfaces from terminations list when connecting a cable
  • #9939 - Fix list of next nodes for split paths under trace view

Plugins API

  • #9075 - Introduce AbortRequest exception for cleanly interrupting object mutations
  • #9092 - Add support for ObjectChildrenView generic view
  • #9228 - Subclasses of ChangeLoggingMixin can override serialize_object() to control JSON serialization for change logging
  • #9414 - Add clone() method to NetBoxModel for copying instance attributes
  • #9647 - Introduce customfield_value template tag

Other Changes

  • #9261 - NetBoxTable no longer automatically clears pre-existing calls to prefetch_related() on its queryset
  • #9434 - Enabled django-rich test runner for more user-friendly output
  • #9903 - Implement a mechanism for automatically updating denormalized fields

REST API Changes

  • List results can now be ordered by field, by appending ?ordering={fieldname} to the query. Multiple fields can be specified by separating the field names with a comma, e.g. ?ordering=site,name. To invert the ordering, prepend a hyphen to the field name, e.g. ?ordering=-name.
  • Added the following endpoints:
    • /api/dcim/cable-terminations/
    • /api/ipam/l2vpns/
    • /api/ipam/l2vpn-terminations/
  • circuits.Circuit
    • Added optional termination_date field
  • circuits.CircuitTermination
    • link_peer has been renamed to link_peers and now returns a list of objects
    • link_peer_type has been renamed to link_peers_type
    • connected_endpoint has been renamed to connected_endpoints and now returns a list of objects
    • connected_endpoint_type has been renamed to connected_endpoints_type
    • connected_endpoint_reachable has been renamed to connected_endpoints_reachable
    • Added custom_fields and tags fields
  • dcim.Cable
    • termination_a_type has been renamed to a_terminations_type
    • termination_b_type has been renamed to b_terminations_type
    • termination_a renamed to a_terminations and now returns a list of objects
    • termination_b renamed to b_terminations and now returns a list of objects
    • termination_a_id has been removed
    • termination_b_id has been removed
  • dcim.ConsolePort
    • link_peer has been renamed to link_peers and now returns a list of objects
    • link_peer_type has been renamed to link_peers_type
    • connected_endpoint has been renamed to connected_endpoints and now returns a list of objects
    • connected_endpoint_type has been renamed to connected_endpoints_type
    • connected_endpoint_reachable has been renamed to connected_endpoints_reachable
  • dcim.ConsoleServerPort
    • link_peer has been renamed to link_peers and now returns a list of objects
    • link_peer_type has been renamed to link_peers_type
    • connected_endpoint has been renamed to connected_endpoints and now returns a list of objects
    • connected_endpoint_type has been renamed to connected_endpoints_type
    • connected_endpoint_reachable has been renamed to connected_endpoints_reachable
  • dcim.Device
    • The position field has been changed from an integer to a decimal
  • dcim.DeviceType
    • The u_height field has been changed from an integer to a decimal
  • dcim.FrontPort
    • link_peer has been renamed to link_peers and now returns a list of objects
    • link_peer_type has been renamed to link_peers_type
    • connected_endpoint has been renamed to connected_endpoints and now returns a list of objects
    • connected_endpoint_type has been renamed to connected_endpoints_type
    • connected_endpoint_reachable has been renamed to connected_endpoints_reachable
  • dcim.Interface
    • link_peer has been renamed to link_peers and now returns a list of objects
    • link_peer_type has been renamed to link_peers_type
    • connected_endpoint has been renamed to connected_endpoints and now returns a list of objects
    • connected_endpoint_type has been renamed to connected_endpoints_type
    • connected_endpoint_reachable has been renamed to connected_endpoints_reachable
    • Added the optional poe_mode and poe_type fields
    • Added the l2vpn_termination read-only field
  • dcim.InterfaceTemplate
    • Added the optional poe_mode and poe_type fields
  • dcim.Location
    • Added required status field (default value: active)
  • dcim.PowerOutlet
    • link_peer has been renamed to link_peers and now returns a list of objects
    • link_peer_type has been renamed to link_peers_type
    • connected_endpoint has been renamed to connected_endpoints and now returns a list of objects
    • connected_endpoint_type has been renamed to connected_endpoints_type
    • connected_endpoint_reachable has been renamed to connected_endpoints_reachable
  • dcim.PowerFeed
    • link_peer has been renamed to link_peers and now returns a list of objects
    • link_peer_type has been renamed to link_peers_type
    • connected_endpoint has been renamed to connected_endpoints and now returns a list of objects
    • connected_endpoint_type has been renamed to connected_endpoints_type
    • connected_endpoint_reachable has been renamed to connected_endpoints_reachable
  • dcim.PowerPort
    • link_peer has been renamed to link_peers and now returns a list of objects
    • link_peer_type has been renamed to link_peers_type
    • connected_endpoint has been renamed to connected_endpoints and now returns a list of objects
    • connected_endpoint_type has been renamed to connected_endpoints_type
    • connected_endpoint_reachable has been renamed to connected_endpoints_reachable
  • dcim.Rack
    • The elevation endpoint now includes half-height rack units, and utilizes decimal values for the ID and name of each unit
  • dcim.RearPort
    • link_peer has been renamed to link_peers and now returns a list of objects
    • link_peer_type has been renamed to link_peers_type
    • connected_endpoint has been renamed to connected_endpoints and now returns a list of objects
    • connected_endpoint_type has been renamed to connected_endpoints_type
    • connected_endpoint_reachable has been renamed to connected_endpoints_reachable
  • extras.ConfigContext
    • Added the locations many-to-many field to track the assignment of ConfigContexts to Locations
  • extras.CustomField
    • Added group_name and ui_visibility fields
  • ipam.IPAddress
    • The nat_inside field no longer requires a unique value
    • The nat_outside field has changed from a single IP address instance to a list of multiple IP addresses
  • ipam.VLAN
    • Added the l2vpn_termination read-only field
  • users.Token
    • Added the allowed_ips array field
    • Added the read-only last_used datetime field
  • virtualization.Cluster
    • Added required status field (default value: active)
  • virtualization.VirtualMachine
    • The site field is now directly writable (rather than being inferred from the assigned cluster)
    • The cluster field is now optional. A virtual machine must have a site and/or cluster assigned.
    • Added the optional device field
    • Added the l2vpn_termination read-only field
  • wireless.WirelessLAN
    • Added tenant field
  • wireless.WirelessLink
    • Added tenant field