NetBox Branching

This NetBox plugin introduces branching functionality. A branch is a discrete, static snapshot of the NetBox database which can be modified independently and later merged back into the main database. This enables users to make "offline" changes to objects within NetBox and avoid interfering with its integrity as the network source of truth. It also provides the opportunity to review changes in bulk prior to their application.

See the compatibility matrix for supported NetBox versions.

Installation

Brief installation instructions are provided below. For a complete installation guide, please refer to the included documentation.

Grant PostgreSQL permission for the NetBox database user to create schemas:

GRANT CREATE ON DATABASE $database TO $user;

Activate the NetBox virtual environment:

$ source /opt/netbox/venv/bin/activate

Install the plugin from PyPI:

$ pip install netboxlabs-netbox-branching

Add netbox_branching to PLUGINS in configuration.py.

PLUGINS = [
    # ...
    'netbox_branching',
]

Configure the database and router in configuration.py:

from netbox_branching.utilities import DynamicSchemaDict

DATABASES = DynamicSchemaDict({
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'netbox',               # Database name
        'USER': 'netbox',               # PostgreSQL username
        'PASSWORD': 'password',         # PostgreSQL password
        'HOST': 'localhost',            # Database server
        'PORT': '',                     # Database port (leave blank for default)
        'CONN_MAX_AGE': 300,            # Max database connection age
    }
})

DATABASE_ROUTERS = [
    'netbox_branching.database.BranchAwareRouter',
]

Run NetBox migrations:

$ ./manage.py migrate

Running Tests

Plugin tests must be run from the NetBox application directory. Pass the PYTHONPATH environment variable to specify the testing/ directory which holds the testing configuration.

cd $NETBOX_ROOT/netbox
PYTHONPATH=$PLUGIN_ROOT/testing \
NETBOX_CONFIGURATION=configuration \
python manage.py test netbox_branching.tests

Metadata

Release files for netboxlabs-netbox-branching 1.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for netboxlabs-netbox-branching 1.2.2
File	Size	Uploaded
netboxlabs_netbox_branching-1.2.2.tar.gz	113.8 kB	Oct 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for netboxlabs-netbox-branching 1.2.2
File	Interpreter	ABI	Platform	Reset
netboxlabs_netbox_branching-1.2.2-py3-none-any.whl 136.1 kB Oct 8, 2026	Python 3	none	any	Details

Total release size: 249.9 kB

Release files / netboxlabs_netbox_branching-1.2.2.tar.gz

Download URL	netboxlabs_netbox_branching-1.2.2.tar.gz
Size	113.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`ab22c479c9d26c5f1ebf725dbe3327068e53c95dd90b6be28fe76566fad80bb4`
BLAKE2b-256 checksum How to use checksums	`21e5444c7bd896ae7e6d13cf5783e413deb98ccefd0da579374843f8678695ff`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/netboxlabs/netbox-branching
Publishing commit: github.com/netboxlabs/netbox-branching/tree/658d654eca9ca9b91297e67bb0bab37c9106a0f3

Workflow

Publishing configuration: github.com/netboxlabs/netbox-branching/blob/658d654eca9ca9b91297e67bb0bab37c9106a0f3/.github/workflows/release.yaml
Publishing logs: github.com/netboxlabs/netbox-branching/actions/runs/37842666443/attempts/1

Artifact

Subject: netboxlabs_netbox_branching-1.2.2.tar.gz
SHA-256 checksum: ab22c479c9d26c5f1ebf725dbe3327068e53c95dd90b6be28fe76566fad80bb4 Verifying attestations

Release files / netboxlabs_netbox_branching-1.2.2-py3-none-any.whl

Download URL	netboxlabs_netbox_branching-1.2.2-py3-none-any.whl
Size	136.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`98155b3bace19bfc6cd1f709ef3ea06448c831ba3611418fabbb04774dc052cb`
BLAKE2b-256 checksum How to use checksums	`fcc9fe498fa701e6a50d8e75c147f4dafa72a4aab22eb346917613447453afb3`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/netboxlabs/netbox-branching
Publishing commit: github.com/netboxlabs/netbox-branching/tree/658d654eca9ca9b91297e67bb0bab37c9106a0f3

Workflow

Publishing configuration: github.com/netboxlabs/netbox-branching/blob/658d654eca9ca9b91297e67bb0bab37c9106a0f3/.github/workflows/release.yaml
Publishing logs: github.com/netboxlabs/netbox-branching/actions/runs/37842666443/attempts/1

Artifact

Subject: netboxlabs_netbox_branching-1.2.2-py3-none-any.whl
SHA-256 checksum: 98155b3bace19bfc6cd1f709ef3ea06448c831ba3611418fabbb04774dc052cb Verifying attestations