Migrating to v0.15.0
What changed in Scanopy v0.15.0 and what you need to do after upgrading.
Scanopy v0.15.0 consolidates the previously separate discovery types (Network Scan, Docker, Self-Report) into a single discovery flow. Daemons now run one discovery that handles network scanning, Docker container discovery, and self-reporting together. Credentials are managed through a universal credential store instead of per-daemon configuration.
Most of the migration is automatic — but there are a few things you need to do manually.
What Happens Automatically
When a daemon running v0.15.0 or later connects, the server:
- Deletes all legacy discoveries (Network Scan, Docker, Self-Report) associated with that daemon
- Creates a single new discovery that combines the functionality of all three
- Preserves your scan schedules and subnet configuration
What You Need to Do
1. Recreate Docker proxy configuration as a credential
If you configured Docker proxy via daemon config (--docker-proxy, SCANOPY_DOCKER_PROXY, or the config file), you need to recreate it as a Docker Proxy credential in the UI.
- Go to Assets > Credentials
- Click Create Credential
- Select Docker Proxy as the type
- Enter the proxy port (default: 2376), optional path, and SSL certificates if applicable
- Save the credential
- Assign it to the target host from the host edit modal (Credentials tab)
The daemon config flags (--docker-proxy, --docker-proxy-ssl-cert, --docker-proxy-ssl-key, --docker-proxy-ssl-chain) still work in v0.15.0 but log deprecation warnings. They will be removed in v0.16.0.
See the Docker Proxy guide for the full setup process.
2. Re-apply scan speed overrides
If you customized scan speed settings in daemon config (--scan-rate-pps, --arp-rate-pps, etc.), those daemon-level values are no longer used. Scan speed is now configured per-discovery.
- Go to Discover > Scan > Scheduled
- Edit the discovery
- Open the Speed tab
- Re-apply your scan rate, ARP rate, and other speed settings
3. Update API integrations
If you have API integrations that create or reference credentials, the SNMP credential type discriminant changed:
| Before | After |
|---|---|
"Snmp" | "SnmpV2c" |
Update any code that creates credentials or filters by credential type. The version selector field has been removed — the type name now includes the version.
New Features in v0.15.0
Credential wizard
When creating a new daemon or editing an existing discovery, a Credentials tab lets you add SNMP and Docker Proxy credentials with target IPs. Credentials are auto-assigned to discovered hosts after the first scan. See Credentials for details.
Docker mode selection
During daemon setup, you can now choose how Docker discovery works:
- Disabled — no Docker scanning
- Local Socket — scan containers via the local Docker socket (default)
- Proxy — scan containers via a remote Docker Proxy credential
Scan lifecycle
Discovery now alternates between light and deep scans on a configurable interval. See Discovery — Scanning Lifecycle for how scan depth works.
Remote Docker scanning
Docker Proxy credentials can point to any reachable Docker API endpoint, enabling container discovery on remote hosts — not just the daemon's own host.
Deprecation Timeline
| Version | Change |
|---|---|
| v0.15.0 | Docker proxy daemon config flags log deprecation warnings. Scan speed daemon config ignored. |
| v0.16.0 | Docker proxy daemon config flags removed entirely. |