v3.1.0-ls48

LinuxServer Changes:

Rebase to Alpine 3.15.

netbox Changes:

Breaking Changes

• NetBox v3.1 requires PostgreSQL 10 or later.
• The tenant and tenant_id filters for the Cable model now filter on the tenant assigned directly to each cable, rather than on the parent object of either termination.
• The cable_peer and cable_peer_type attributes of cable termination models have been renamed to link_peer and link_peer_type, respectively, to accommodate wireless links between interfaces.
• Exported webhooks and custom fields now reference associated content types by raw string value (e.g. "dcim.site") rather than by human-friendly name.
• The 128GFC interface type has been corrected from 128gfc-sfp28 to 128gfc-qsfp28.

New Features

Contact Objects (#1344)

A set of new models for tracking contact information has been introduced within the tenancy app. Users may now create individual contact objects to be associated with various models within NetBox. Each contact has a name, title, email address, etc. Contacts can be arranged in hierarchical groups for ease of management.

When assigning a contact to an object, the user must select a predefined role (e.g. "billing" or "technical") and may optionally indicate a priority relative to other contacts associated with the object. There is no limit on how many contacts can be assigned to an object, nor on how many objects to which a contact can be assigned.

Wireless Networks (#3979)

This release introduces two new models to represent wireless networks:

• Wireless LAN - A multi-access wireless segment to which any number of wireless interfaces may be attached
• Wireless Link - A point-to-point connection between exactly two wireless interfaces

Both types of connection include SSID and authentication attributes. Additionally, the interface model has been extended to include several attributes pertinent to wireless operation:

• Wireless role - Access point or station
• Channel - A predefined channel within a standardized band
• Channel frequency & width - Customizable channel attributes (e.g. for licensed bands)

Dynamic Configuration Updates (#5883)

Some parameters of NetBox's configuration are now accessible via the admin UI. These parameters can be modified by an administrator and take effect immediately upon application: There is no need to restart NetBox. Additionally, each iteration of the dynamic configuration is preserved in the database, and can be restored by an administrator at any time.

Dynamic configuration parameters may also still be defined within configuration.py, and the settings defined here take precedence over those defined via the user interface.

For a complete list of supported parameters, please see the dynamic configuration documentation.

First Hop Redundancy Protocol (FHRP) Groups (#6235)

A new FHRP group model has been introduced to aid in modeling the configurations of protocols such as HSRP, VRRP, and GLBP. Each FHRP group may be assigned one or more virtual IP addresses, as well as an authentication type and key. Member device and VM interfaces may be associated with one or more FHRP groups, with each assignment receiving a numeric priority designation.

Conditional Webhooks (#6238)

Webhooks now include a conditions field, which may be used to specify conditions under which a webhook triggers. For example, you may wish to generate outgoing requests for a device webhook only when its status is "active" or "staged". This can be done by declaring conditional logic in JSON:

{
  "attr": "status.value",
  "op": "in",
  "value": ["active", "staged"]
}

Multiple conditions may be nested using AND/OR logic as well. For more information, please see the conditional logic documentation.

Interface Bridging (#6346)

A bridge field has been added to the interface model for devices and virtual machines. This can be set to reference another interface on the same parent device/VM to indicate a direct layer two bridging adjacency. Additionally, "bridge" has been added as an interface type. (However, interfaces of any type may be designated as bridged.)

Multiple interfaces can be bridged to a single virtual interface to effect a bridge group. Alternatively, two physical interfaces can be bridged to one another, to effect an internal cross-connect.

Multiple ASNs per Site (#6732)

With the introduction of the new ASN model, NetBox now supports the assignment of multiple ASNs per site. Each ASN instance must have a 32-bit AS number, and may optionally be assigned to a RIR and/or Tenant.

The asn integer field on the site model has been preserved to maintain backward compatability until a later release.

Single Sign-On (SSO) Authentication (#7649)

Support for single sign-on (SSO) authentication has been added via the python-social-auth library. NetBox administrators can configure one of the supported authentication backends to enable SSO authentication for users.

Enhancements

• #1337 - Add WWN field to interfaces
• #1943 - Relax uniqueness constraint on cluster names
• #3839 - Add airflow field for devices types and devices
• #5143 - Include a device's asset tag in its display value
• #6497 - Extend tag support to organizational models
• #6615 - Add filter lookups for custom fields
• #6711 - Add longtext custom field type with Markdown support
• #6715 - Add tenant assignment for cables
• #6874 - Add tenant assignment for locations
• #7354 - Relax uniqueness constraints on region, site group, and location names
• #7452 - Add json custom field type
• #7530 - Move device type component lists to separate views
• #7606 - Model transmit power for interfaces
• #7619 - Permit custom validation rules to be defined as plain data or dotted path to class
• #7761 - Extend cable tracing across bridged interfaces
• #7812 - Enable change logging for image attachments
• #7858 - Standardize the representation of content types across import & export functions

Bug Fixes

• #7589 - Correct 128GFC interface type identifier

Other Changes

• #7318 - Raise minimum required PostgreSQL version from 9.6 to 10

REST API Changes

• Added the following endpoints for ASNs:
  • /api/ipam/asn/
• Added the following endpoints for FHRP groups:
  • /api/ipam/fhrp-groups/
  • /api/ipam/fhrp-group-assignments/
• Added the following endpoints for contacts:
  • /api/tenancy/contact-assignments/
  • /api/tenancy/contact-groups/
  • /api/tenancy/contact-roles/
  • /api/tenancy/contacts/
• Added the following endpoints for wireless networks:
  • /api/wireless/wireless-lans/
  • /api/wireless/wireless-lan-groups/
  • /api/wireless/wireless-links/
• Added tags field to the following models:
  • circuits.CircuitType
  • dcim.DeviceRole
  • dcim.Location
  • dcim.Manufacturer
  • dcim.Platform
  • dcim.RackRole
  • dcim.Region
  • dcim.SiteGroup
  • ipam.RIR
  • ipam.Role
  • ipam.VLANGroup
  • tenancy.ContactGroup
  • tenancy.ContactRole
  • tenancy.TenantGroup
  • virtualization.ClusterGroup
  • virtualization.ClusterType
• circuits.CircuitTermination
  • cable_peer has been renamed to link_peer
  • cable_peer_type has been renamed to link_peer_type
• dcim.Cable
  • Added tenant field
• dcim.ConsolePort
  • cable_peer has been renamed to link_peer
  • cable_peer_type has been renamed to link_peer_type
• dcim.ConsoleServerPort
  • cable_peer has been renamed to link_peer
  • cable_peer_type has been renamed to link_peer_type
• dcim.Device
  • The display field now includes the device's asset tag, if set
  • Added airflow field
• dcim.DeviceType
  • Added airflow field
• dcim.FrontPort
  • cable_peer has been renamed to link_peer
  • cable_peer_type has been renamed to link_peer_type
• dcim.Interface
  • cable_peer has been renamed to link_peer
  • cable_peer_type has been renamed to `link_p...

v3.0.12-ls47

LinuxServer Changes:

Added Redis database environment variables.

netbox Changes:

Enhancements

• #7751 - Get API user from LDAP only when FIND_GROUP_PERMS is enabled
• #7885 - Linkify VLAN name in VLANs table
• #7892 - Add L22-30 power port & outlet types
• #7932 - Improve performance of the "quick find" function
• #7941 - Add multi-standard ITA power outlet type

Bug Fixes

• #7823 - Fix issue where return_url is not honored when 'Save & Continue' button is present
• #7981 - Fix Markdown sanitization regex

v3.0.11-ls47

LinuxServer Changes:

Added Redis database environment variables.

netbox Changes:

Enhancements

• #2101 - Add missing q filters for necessary models
• #7424 - Add virtual chassis filters for device components
• #7531 - Add Markdown support for strikethrough formatting
• #7542 - Add optional VLAN group column to prefixes table
• #7803 - Improve live reloading of custom scripts
• #7810 - Add IEEE 802.15.1 interface type

Bug Fixes

• #7399 - Fix excessive CPU utilization when AUTH_LDAP_FIND_GROUP_PERMS is enabled
• #7657 - Make change logging middleware thread-safe
• #7720 - Fix initialization of custom script MultiObjectVar field with multiple values
• #7729 - Fix permissions evaluation when displaying VLAN group VLANs table
• #7739 - Fix exception when tracing cable across circuit with no far end termination
• #7813 - Fix handling of errors during export template rendering
• #7851 - Add missing cluster name filter for virtual machines
• #7857 - Fix ordering IP addresses by assignment status
• #7859 - Fix styling of form widgets under cable connection views
• #7864 - power_port can be null when creating power outlets via REST API
• #7865 - REST API should support null values for console port speeds

v3.0.11-ls46

LinuxServer Changes:

Added Redis database environment variables.

netbox Changes:

Enhancements

• #2101 - Add missing q filters for necessary models
• #7424 - Add virtual chassis filters for device components
• #7531 - Add Markdown support for strikethrough formatting
• #7542 - Add optional VLAN group column to prefixes table
• #7803 - Improve live reloading of custom scripts
• #7810 - Add IEEE 802.15.1 interface type

Bug Fixes

• #7399 - Fix excessive CPU utilization when AUTH_LDAP_FIND_GROUP_PERMS is enabled
• #7657 - Make change logging middleware thread-safe
• #7720 - Fix initialization of custom script MultiObjectVar field with multiple values
• #7729 - Fix permissions evaluation when displaying VLAN group VLANs table
• #7739 - Fix exception when tracing cable across circuit with no far end termination
• #7813 - Fix handling of errors during export template rendering
• #7851 - Add missing cluster name filter for virtual machines
• #7857 - Fix ordering IP addresses by assignment status
• #7859 - Fix styling of form widgets under cable connection views
• #7864 - power_port can be null when creating power outlets via REST API
• #7865 - REST API should support null values for console port speeds

v3.0.10-ls45

LinuxServer Changes:

Added Redis database environment variables.

netbox Changes:

Enhancements

• #7740 - Add mini-DIN 8 console port type
• #7760 - Add vid filter field to VLANs list
• #7767 - Add visual aids to interfaces table for type, enabled status

Bug Fixes

• #7564 - Fix assignment of members to virtual chassis with initial position of zero
• #7701 - Fix conflation of assigned IP status & role in interface tables
• #7741 - Fix 404 when attaching multiple images in succession
• #7752 - Fix minimum version check under Python v3.10
• #7766 - Add missing outer dimension columns to rack table
• #7780 - Preserve multi-line values during CSV file import
• #7783 - Fix indentation of locations under site view
• #7788 - Improve XSS mitigation in Markdown renderer
• #7791 - Enable sorting device bays table by installed device status
• #7802 - Differentiate ID and VID columns in VLANs table
• #7808 - Fix reference values for content type under custom field import form
• #7809 - Add missing export template support for various models
• #7814 - Fix restriction of user & group objects in GraphQL API queries

v3.0.10-ls44

LinuxServer Changes:

Added Redis database environment variables.

netbox Changes:

Enhancements

• #7740 - Add mini-DIN 8 console port type
• #7760 - Add vid filter field to VLANs list
• #7767 - Add visual aids to interfaces table for type, enabled status

Bug Fixes

• #7564 - Fix assignment of members to virtual chassis with initial position of zero
• #7701 - Fix conflation of assigned IP status & role in interface tables
• #7741 - Fix 404 when attaching multiple images in succession
• #7752 - Fix minimum version check under Python v3.10
• #7766 - Add missing outer dimension columns to rack table
• #7780 - Preserve multi-line values during CSV file import
• #7783 - Fix indentation of locations under site view
• #7788 - Improve XSS mitigation in Markdown renderer
• #7791 - Enable sorting device bays table by installed device status
• #7802 - Differentiate ID and VID columns in VLANs table
• #7808 - Fix reference values for content type under custom field import form
• #7809 - Add missing export template support for various models
• #7814 - Fix restriction of user & group objects in GraphQL API queries

v3.0.9-ls43

LinuxServer Changes:

Added Redis database environment variables.

netbox Changes:

Enhancements

• #6529 - Introduce the runscript management command
• #6930 - Add an optional "ID" column to all tables
• #7668 - Add "view elevations" button to location view

Bug Fixes

• #7599 - Improve color mode preference handling
• #7601 - Correct devices count for locations within global search results
• #7612 - Strip HTML from custom field descriptions
• #7628 - Fix load_yaml method for custom scripts
• #7643 - Fix circuit assignment when creating multiple terminations simultaneously
• #7644 - Prevent inadvertent deletion of prior change records when deleting objects (#7333 revisited)
• #7647 - Require interface assignment when designating IP address as primary for device/VM during CSV import
• #7664 - Preserve initial form data when bulk edit validation fails
• #7717 - Restore missing tags column on IP range table
• #7721 - Retain pagination preference when MAX_PAGE_SIZE is zero

v3.0.8-ls43

LinuxServer Changes:

Added Redis database environment variables.

netbox Changes:

Enhancements

• #7551 - Add UI field to filter interfaces by kind
• #7561 - Add a utilization column to the IP ranges table

Bug Fixes

• #7300 - Fix incorrect Device LLDP interface row coloring
• #7495 - Fix navigation UI issue that caused improper element overlap
• #7529 - Restore horizontal scrolling for tables in narrow viewports
• #7534 - Avoid exception when utilizing "create and add another" twice in succession
• #7544 - Fix multi-value filtering of custom field objects
• #7545 - Fix incorrect display of update/delete events for webhooks
• #7550 - Fix rendering of UTF8-encoded data in change records
• #7556 - Fix display of version when new release is available
• #7584 - Fix alignment of object identifier under object view

v3.0.8-ls42

LinuxServer Changes:

Added Redis database environment variables.

netbox Changes:

Enhancements

• #7551 - Add UI field to filter interfaces by kind
• #7561 - Add a utilization column to the IP ranges table

Bug Fixes

• #7300 - Fix incorrect Device LLDP interface row coloring
• #7495 - Fix navigation UI issue that caused improper element overlap
• #7529 - Restore horizontal scrolling for tables in narrow viewports
• #7534 - Avoid exception when utilizing "create and add another" twice in succession
• #7544 - Fix multi-value filtering of custom field objects
• #7545 - Fix incorrect display of update/delete events for webhooks
• #7550 - Fix rendering of UTF8-encoded data in change records
• #7556 - Fix display of version when new release is available
• #7584 - Fix alignment of object identifier under object view

v3.0.7-ls41

LinuxServer Changes:

Added Redis database environment variables.

netbox Changes:

Enhancements

• #6879 - Improve ability to toggle images/labels in rack elevations
• #7485 - Add USB micro AB type

Bug Fixes

• #7051 - Fix permissions evaluation and improve error handling for connected device REST API endpoint
• #7471 - Correct redirect URL when attaching images via "add another" button
• #7474 - Fix AttributeError exception when rendering a report or custom script
• #7479 - Fix parent interface choices when bulk editing VM interfaces