Automatically maintain an up-to-date inventory of active IP addresses in your network using Netbox and nmap. This Python-based tool scans your network prefixes and keeps your Netbox instance synchronized with the current state of your network.
- Automatic scanning of all active prefixes in Netbox
- Custom tag support for excluding prefixes from scanning
- Tracking of last scan time for each IP address
- DNS resolution support (optional)
- Tested with Python 3.12.6 - 3.13.1 and Netbox 4.1.10
- Python 3.12.6 or later
- Netbox 4.1.10 or later
- nmap installed on your system
- Required Python packages (listed in requirements.txt)
-
Create the following Netbox configurations:
autoscan: Identifies IP addresses added by this scriptDisable Automatic Scanning: Add this tag to prefixes you want to exclude from scanning
Add a custom field to track the last scan time for each IP address:
-
Follow the detailed installation guide in our Wiki
The script will scan all prefixes with active status in your Netbox instance by default. Scanning time increases with the number of prefixes being scanned.
For detailed usage instructions and examples, please refer to our Wiki.
- Scanning time scales with the number of prefixes
- Consider scheduling scans during off-peak hours for large networks
- Use the
Disable Automatic Scanningtag strategically to optimize scan times
- DNS server configuration in INI file for custom DNS resolution
- Option to disable DNS resolution functionality
- Toggle for last scan time tracking
- Toggle for the progress bar display while importing
- Toggle for the logger in the Python console
- All-in-One setup script for easier deployment
Contributions are welcome! Please feel free to submit a Pull Request.
For issues, questions, or contributions, please:
- Check our Wiki
- Open an issue in this repository
- Submit a pull request with your proposed changes