Netpicker

Release notes

How to update

You can easily update to the latest version by running the following command in the netpicker directory:

bash down.sh && bash up.sh

2024-10-15 – Bulk edit for device platform, sorted platform and tag lists

2024-10-14 – Dedicated connection support, bugfixes

We’ve added an option to use dedicated network connections when connecting to devices: Dedicated network connections

2024-10-03 – Bugfix for importing more than 1000 devices from Slurp’it

2024-10-01 – OAuth support, Linux sudo support, bulk edit SSH port

  • We’ve added support for signing into Netpicker using OAuth. This means you can use Single Sign-On using Microsoft Azure AD / Entra ID, Google or any OAuth identity provider. Contact us for help setting this up for your environment.
  • We’ve added Linux sudo support when running device.cli commands using Entering configuration / edit / enable / sudo mode
  • We’ve added the option to edit the SSH port for devices using Bulk edit.

2024-09-23 – Bugfix for device tags in rules

When using device tags in a Python rule, the device parameter would not always be device you intended to run the test against. This has been fixed.

2024-09-17 – Custom timeouts, custom config backup commands

  • We’ve added support for setting custom (Netmiko) timeouts using device tags. For this, you need to add some extra environment variables in the docker-compose file. Check out our guide here: Custom device timeout setup
  • Added support for custom config backup commands using device tags, check out our guide here: Custom config backup command setup

2024-09-12 – Backup status, OpsMill Infrahub integration, device configuration mode

  • The backups section now shows the status of the backups per device including any errors and logs, so you can easily see if everything works as expected.
  • Added support for the OpsMill Infrahub Python library in the Netpicker rules, so you can easily connect to Infrahub as Network Source of Truth. Check out our example integration rule on our pytests-for-networking repository.
  • Added support to enter ‘configuration mode’, ‘edit mode’ or ‘enable mode’ for a device: Entering configuration / edit / enable mode

2024-09-03 – Bugfix for editing the elevated secret in the vault and new device selector in debug screen

2024-08-26 – Bugfixes for config backups

2024-08-07 – Bugfix for config backup list

2024-08-05 – Bugfix for storing vault credentials

2024-08-01 – Performance and results improvements

Note: this update includes changes to the docker-compose.yml file. Please pull the latest version by running git pull in the netpicker directory. View the changes

  • Performance improvements: We’ve improved the backup and test run performance for users with a large amount of devices.
  • Results and report consistency: We’ve addressed some issues where the results and reports contained outdated information.
  • Added a diff viewer for configuration and command backup history (see screenshot below)
  • Added manual options to Run backups for all or a selection of devices
  • Redesigned the Vault for a better user experience
  • Fixed some network issues with importing devices from Slurp’it

2024-07-11 – Notification for failed backups using webhook

When a config backup could not be made for a device (because the device is offline or doesn’t respond in time for example), you now get a notification via the webhooks. Check our our Webhook documentation for more details.

2024-07-09 – Bugfix for edit rule

This release fixes issues with updating the properties of a simple rule.

2024-07-01 – Bugfix for Netbox import

This release makes the import of devices from a Netbox API endpoint more robust.

2024-06-27 – Bugfixes

Fix for doing manual and scheduled backups and saving webhooks.

2024-06-24 – Delete user, new Virtual Appliance (OVA)

This release adds the functionality to delete users from the Admin section and introduces a new, more compatible Virtual Appliance (OVA) to run in VirtualBox or VMware. Check out the OVA installation manual.

2024-06-19 – User permissions, licence management, system logs and bugfixes

  • User Permissions: You can now add users with a ‘Viewer’ role. This role allows users to view devices, policies, rules and results without the ability to modify anything using Netpicker.
  • License Management: You can now see which devices have an expired license.
  • System Logs: You can now view the system logs (Docker) from the Admin section, improving system monitoring and troubleshooting.
  • Bugfixes:
    • Modifying the platform or severity of a rule should now work as expected, resolving previous issues with these modifications.
    • As an admin, you can now change your password from the Admin -> Users section.

2024-06-10 – Bugfixes for policy results, rule execution and simple rules

You should now be able to view the results on policy level again and execute policies or rules manually. Also, regular expressions in simple configuration rules are working as they should.

2024-06-06 – Bugfix for import devices

A small release which fixes issues with importing devices from NetBox or Slurp’it.

2024-06-05 – JSON selector in simple rules

This release adds JSON selector support for the simple rules. If you use a command which returns JSON output, you can select a property from the output and create a test for just this property.

Also, you can now see the number of devices in the filter selectors on the Devices and Backups screens.

2024-05-27 – SSO and real-time commands in simple rules

This release adds support for Single Sign-On via a SAML Identity Provider. Please contact us in order to set this up for your environment.

Also, we’ve added support for real-time commands in the simple rules:

2024-05-23 – Webhook notifications

This release adds webhook support. With webhooks, you can notify third-party systems when Netpicker has finished a process such as backing up device configurations or executing policies / rules.

Check out our documentation on how to set up webhooks in Netpicker.

2024-05-02 – pynetbox integration

This release adds support for pynetbox, the Python API client library for NetBox.

To set it up, you need to provide the API endpoint and your token as two extra environment variables in the docker-compose.yml file for the x-api:

x-api: &api_common
  environment:
    NETBOX_API: "https://endpoint_here/"
    NETBOX_TOKEN: enter_token_here

After setting this up, you can use the netbox parameter in the Python tests:

2024-04-18 – Bulk edit of devices

This release of Netpicker adds the following features:

  • Bulk edit of devices: add and remove tags and set vault

You can easily update to the latest version by running the following command in the netpicker directory:

bash down.sh && bash up.sh

2024-04-03 – Reports

This release of Netpicker adds the following features:

  • Generate reports on device, device tag and policy level results with PDF export
  • Change user e-mail and password
  • CSV export of devices

2024-03-20 – CIS and CVE policies, import devices

Today, we’re releasing a new version of Netpicker which includes the following major changes:

This release contains breaking changes in the database model, so we advise you to start with a clean installation using Docker or the Virtual Appliance (OVA). If you already have Netpicker running on your system, please follow the clean installation guide.

2024-03-07 – Config backup, network testing

The first release of Netpicker! This release contains:

  • Device configuration backup
  • Python testing support for a single device or multiple devices
  • Exporting of the test results to CSV