Skip to content

v4 Release Notes

v4.3.2 (2025-10-29)

Changes

  • All user-facing strings are now marked for translation.
  • Added Ready to merge and Merging statuses to Sync to differentiate between sync and merge.
  • Added status choices to Sync filter.
  • Docs contain new Troubleshooting section with common issues and their solutions.
  • Improved docs regarding logging setup.

Fixes

  • Correctly serialize status for IPFabricSync REST API.

v4.3.1 (2025-10-14)

Changes

  • Removed manual Transform Maps installation from docs since it’s obsolete.
  • Added bulk operations to all needed models.
  • Transform map target model and Relationship field source model are correctly displayed in list view.
  • ValidationError on Transform Map conflict is now more specific.
  • IPFabricSync sync job scheduling moved from form to model save().
  • New REST API endpoint to trigger sync of IPFabricSource and IPFabricSync.
  • Added link from Sync detail to the scheduled Job.
  • Scheduled time on Sync is now updated to future whenever a scheduled Job is run.
  • Automatically delete Branch if sync is set to auto merge.

Fixes

  • Table of contents in Transform Maps docs was incomplete.
  • Part number did not have human-readable choice causing unexpected bugs.
  • Only allowed actions on list views are now shown.
  • Parameters passed to IPFabricSync via API is correctly parsed to JSON.
  • Unified permission ipfabric_netbox.start_ipfabricsync to ipfabric_netbox.sync_ipfabricsync
  • Scheduled Jobs are no longer duplicated when editing an existing Sync.
  • Ingestion detail view works even when Job is manually deleted.
  • Disabled Merge button on Ingestion if Branch is already merged.

v4.3.0 (2025-09-23)

Warning

This release requires at least NetBox v4.4.0.

Changes

  • Support for NetBox v4.4.0+.
  • Optimization: Objects are checked for changes before validation and saving to the database. This should significantly reduce the time needed for syncing when there are only few changes.
  • Replace custom Sync table with NetBox’s built-in list table.
  • Added option to completely skip syncing custom fields to avoid empty updates.
  • Added full GraphQL support for all models.
  • IPFabricSource API now supports brief parameter.
  • API serializers now support depth parameter to control how many nested objects are serialized.
  • All direct REST API endpoints now support full CRUD operations except for IPFabricSnapshot, IPFabricIngestion and IPFabricIngestionIssue which are read-only.
  • Removed type from IPFabricSyncForm, all models are now visible by default.
  • IPFabricTransformMap and IPFabricTransformMapGroup forms now allows for tagging.
  • Custom permissions now follow NetBox’s standard naming scheme <app_label>.<action>_<model_name>. Following renames were made:
    • ipfabric_netbox.tm_restore -> ipfabric_netbox.restore_ipfabrictransformmap
    • ipfabric_netbox.ipfabrictransformmap_add -> ipfabric_netbox.clone_ipfabrictransformmap
    • ipfabric_netbox.sync_source -> ipfabric_netbox.sync_ipfabricsource
    • ipfabric_netbox.start_sync -> ipfabric_netbox.start_ipfabricsync
    • ipfabric_netbox.merge_ingestion -> ipfabric_netbox.merge_ipfabricingestion
  • When cloning an IPFabricTransformMap, the redirect now points to the clones map.
  • Source is found using Site when custom field containing IPFabricSource ID is empty. This happens when custom fields are ignored during sync.
  • All sync parameters are now enabled by default on new sync creation.
  • Updated netbox-branching to 0.7.0.

Fixes

  • Improved docs section regarding upgrade issues with NetBox v4.3.0+.
  • extra group for IPF SDK version 7.3 was incorrectly pointing to 7.2.
  • Fixed wrong filter set on IPFabricRelationshipField API view.
  • IPFabricSource.status API serializer is now correctly read-only.
  • Added missing filter sets for IPFabricSync and IPFabricRelationshipField API views.
  • brief parameter in most API serializers will now correctly return simplified data.
  • Fixed several small bugs in forms backend found with new tests.
  • Removed obsolete GitLab reference when restoring transform maps.
  • All views now correctly handle situation where non HTMX request is made when only HTMX is expected.
  • IPFabricSync bulk deletion was using IPFabricSnapshot table instead IPFabricSync table.
  • Since NetBox 4.3.0 Topology button was show on all models. It’s back to only Site.
  • Values in IPFabricSync form were not populated from existing instance on edit.
  • IPFabricSync form HTMX GET URL was getting longer with each change of source field.

v4.2.2 (2025-09-12)

Fixes

  • Source detail view no longer crashes with 'str' object has no attribute '_meta' error on NetBox 4.3.7+.

v4.2.1 (2025-08-27)

Fixes

  • Topology no longer crashes when opening Site detail.

v4.2.0 (2025-07-18)

Changes

  • Enhanced Installation Guide.
  • All data in Ingestion detail views (newly statistics and tabs) are now updated every 5 seconds with the logs.
  • Most issues during ingestion are now stored as IPFabricIngestionIssue objects and can be viewed in separate Ingestion detail tab view.
  • Ingestion will show as passed when no errors occurred and only some issues were found.
  • Added extra group for IPF SDK version 7.3.

Fixes

  • Device topology view was using the wrong data for Site ID.
  • Sync settings are more strictly respected in the sync process. This applies for all models but Device and Interface which need to be obtained from the database if their child models are asked to be synced.

v4.1.0 (2025-06-24)

Changes

  • Added IPFabricTransformMapGroup model to group IPFabricTransformMap objects together.
  • Restoring transform maps restores only those with no group assigned.
  • Sync now prioritizes using transform maps from groups specified in the sync settings.
  • Dropped extra group support for IPF SDK < 6.10 and added version 7.2.

Fixes

  • Fixed topology view hanging on error.
  • Updated docs to incorporate local_settings.py into configuration.py.

v4.0.1 (2025-06-03)

Fixes

  • NetBox plugin list showed the previous version as installed.

v4.0.0 (2025-05-27)

Changes

Required upgrade steps

For successful migration please follow netbox-branching installation instructions. Step 3 and 4 should be enough since the plugin is installed as dependency and just needs enabling and configuring.

Simplified installation instructions:

Modify your configuration.py with the following content. Replace $ORIGINAL_DATABASE_CONFIG with your original DATABASE configuration dictionary. If you are using other DATABASE_ROUTERS, make sure to include them in the list. 

from netbox_branching.utilities import DynamicSchemaDict

# Wrap DATABASES with DynamicSchemaDict for dynamic schema support
DATABASES = DynamicSchemaDict({
    'default': $ORIGINAL_DATABASE_CONFIG,
})

# Employ netbox-branching custom database router
DATABASE_ROUTERS = [
    'netbox_branching.database.BranchAwareRouter',
]

# Add `netbox-branching` to plugins list (must be last!)
PLUGINS = [
    # ...
    'netbox_branching',
]

Danger

When upgrading to v4.0.0+, make sure to upgrade at the same step as NetBox to 4.3.0+. If you already upgraded your NetBox instance, follow Cannot resolve bases for [<ModelState: 'ipfabric_netbox.IPFabricBranch'>] instructions.

  • Renamed ingestion -> sync and branch -> ingestion to avoid conflicts with netbox-branching.
  • Renamed Name -> Object in list of ingestion changes and linked to the item if it exists.
  • Removed unused status field from IPFabricTransformMap and cleaned all references.

Fixes

  • Quick search for staged changes was ignoring their values.
  • Sync for InventoryItem failed when name was longer than 64 characters.
  • Unable to delete IP Fabric Ingestion in UI.
  • Data were not validated on model save.

Warning

This will cause more failures during data ingestion. These are not new, but are not hidden anymore. It would cause error when manipulating the faulty object synced by previous versions.

  • Ingestion Job was listed in Sync and not in Ingestion.
  • The Default value for template is empty string instead of None.
  • duplex and speed on Interface take unknown value as None.
  • Correctly set DeviceType when model is empty.
  • Convert platform to slug when using it for DeviceType.
  • Ignored VLAN with VLAN ID 0.
  • Ignore InventoryItems with None serial number.