Browse Deployment & Agents
- Application categories (Zero Trust app management)
- Active Directory group policies
- Content categories
- Custom block pages
- Don't mix DNS providers
- Prevent DNS bypass
- Safe Search explained
- Safe Search supported search engines
- Security categories
- Working with policies
- Working with allow and block lists
- YouTube Restricted Mode explained
Agent download link not working
If the device-agent installer download fails with a 404, a broken file, or stops mid-download, here are the common causes and how to fix each.
If clicking Download on an install key returns a 404, an empty file, or a corrupted installer, work through the checks below.
Verify the key is still valid
Install keys have a duration and an install cap. Both can expire before the download is attempted.
- Open the profile in the Admin Console.
- Find the key under the Install Keys list.
- Confirm Duration has not lapsed and Installs remaining is greater than zero.
If either is expired, edit the key to extend the duration or raise the install cap, then retry the download. See Roaming clients (device agents) for key configuration details.
Re-generate the key
If the key was created some time ago, try deleting it and creating a fresh one. Pre-generated install files are tied to the key version and rotate when the profile’s signing material is updated.
[!NOTE] Already-installed agents are not affected by deleting or rotating a key. Keys are only consumed during initial registration.
Check your browser
Browsers occasionally interfere with installer downloads:
- Ad blockers / privacy extensions can block
.msior.pkgdownloads. Disable them on the ScoutDNS Admin Console domain (app.scoutdns.comorcloud.scoutdns.com) and retry. - Safe Browsing / SmartScreen may flag the file as “uncommonly downloaded.” The file is signed; choose Keep to complete the save.
- Corporate proxy / WAF may rewrite or strip the download. Try downloading from a network that doesn’t transit the proxy as a test.
Confirm the right installer
Each key generates a platform-specific file:
| Platform | File | Common confusion |
|---|---|---|
| Windows x64 | .msi | Don’t run on macOS |
| Windows x86 | .msi | Only for legacy 32-bit Windows |
| macOS Intel (x86) | .pkg | Don’t run on Apple Silicon |
| macOS Apple Silicon (ARM) | .pkg | Don’t run on Intel Macs |
A mismatched platform won’t install. If you need to support both Intel and Apple Silicon Macs, generate one key per architecture.
Still stuck?
If the download keeps failing on a fresh key, on a clean browser, and from a network with no proxy in front, contact support with:
- The profile name
- The install key ID (visible in the Install Keys list)
- A screenshot of the error or the network request from your browser’s developer tools