add 2 metoths

README.md

@@ -0,0 +1,71 @@
+# Netbox Scanner
+
+This repository includes a simple Dockerized network scanner and a NetBox importer.
+
+## Services
+
+- `scanner`: runs `scan.py` and saves scan results to `output/network.txt`
+- `netbox-importer`: runs `ipscan-v2.py` and imports scan results into NetBox
+
+## Files
+
+- `scan.py`: performs Nmap scans for configured networks and writes `network.txt`
+- `ipscan-v2.py`: imports scan results into NetBox using environment variables
+- `docker-compose.yml`: defines `scanner` and `netbox-importer` services
+- `Dockerfile`: installs Python and Nmap and copies both scripts into the container
+
+## Usage
+
+### Build and run the scanner
+
+```bash
+docker compose build
+docker compose up scanner
+```
+
+The scan output is written to:
+
+```bash
+./output/network.txt
+```
+
+### Run the NetBox importer
+
+```bash
+docker compose up netbox-importer
+```
+
+## Configuration
+
+### Scanner service
+
+- `OUTPUT_PATH`: path to save results inside container (default: `/app/output/network.txt`)
+- `SCAN_NETWORKS`: comma-separated CIDR networks to scan (default set in `scan.py`)
+
+### NetBox importer service
+
+- `NETBOX_URL`: NetBox API URL
+- `NETBOX_TOKEN`: NetBox API token
+- `NETWORKS`: comma-separated networks to scan
+- `TENANT`: NetBox tenant name
+- `SSL_VERIFY`: whether to verify SSL (`false`, `0`, `no` disable verification)
+
+## Output format
+
+The generated `network.txt` file includes scan results in this format:
+
+```text
+# network.txt generated on 2026-05-20T00:00:00Z
+# host status open_ports
+192.168.85.1 up 22 80
+192.168.85.2 down
+```
+
+## Notes
+
+- Ensure `nmap` is installed in the container via the provided `Dockerfile`.
+- If you want to run both services together, use:
+
+```bash
+docker compose up scanner netbox-importer
+```