How it works, in one sentence
An agent you’ve already installed scans its local network, finds nearby Windows machines that don’t have AssetGullak yet, and — using credentials you provide for that one job only — copies the installer over and runs it remotely. Nothing new needs installing on the relay itself; it’s just acting as your hands on that network.Before you start
The relay device needs:- Windows 10 or 11
- AssetGullak already installed and showing Online
- The same local network as your target devices
- Windows 10 or 11, on the same network as the relay
- Network profile set to Private (not Public)
- File and Printer Sharing turned on
- WinRM (Windows Remote Management) enabled
- A local or domain account with Administrator rights and a real password set — accounts with no password can’t be used
One-time setup commands for target devices
One-time setup commands for target devices
Run once per target, in an elevated PowerShell window:The registry key is only required if the account you’ll use isn’t the literal built-in “Administrator” account.
One-time setup on the relay (non-domain targets only)
One-time setup on the relay (non-domain targets only)
"*" trusts every host, which is fine on a private office network — for anything more exposed, scope it to your specific subnet instead.Running it
From Devices → Add → Deploy to network, a 4-step wizard walks you through the whole job.Pick a relay and a scan range
The relay dropdown only shows devices currently Online. Leave Auto-detect selected unless you specifically need a different subnet — it derives the relay’s own network range automatically.
Enter credentials for the target devices
The account needs local Administrator rights on the target machines — not necessarily your own AssetGullak login. See the security note below for what happens to this password.
Review what was found
The scan lists every device on that network, reachable or not, with already-enrolled devices greyed out automatically — they’re never reinstalled. Uncheck anything you don’t want touched (printers and other non-installable gear are shown but unchecked by default).
About that password
Handing over a domain admin account is a reasonable thing to be cautious about, so here’s exactly what happens to it:- It travels directly to the relay for this one job — encrypted the entire time it’s stored, for the short window between when you submit it and when the relay picks up the job (usually seconds).
- It’s used in memory on the relay only, for exactly as long as this job runs, and never written to disk there.
- It’s never included in any log, on the relay or on our servers.
- The enrollment key generated for this job is single-use and expires within the hour — it can’t be reused for anything beyond this one batch.
After it finishes
Successfully installed devices show up on your Devices page the same way any agent install does — from there, they behave identically to a manually installed agent. Anything that failed can be retried individually, either manually or by running the wizard again against just those IPs.Troubleshooting
A device isn't showing up in the scan results
A device isn't showing up in the scan results
The scan filters out routers, printers, and other non-Windows gear automatically. If a real Windows machine is missing, check it’s reachable from the relay:A failure here usually means File and Printer Sharing or the network profile isn’t set correctly yet — see the setup commands above.
"Access is denied" or SMB auth failed
"Access is denied" or SMB auth failed
The most common cause is the account having no password set — Windows won’t authenticate a passwordless account remotely. The second most common cause is the
LocalAccountTokenFilterPolicy registry key (see setup above) not being set, which is required for any admin account other than the built-in “Administrator.”WinRM / remote execution errors
WinRM / remote execution errors
Confirm WinRM is enabled on the target (If this returns the target’s computer name, WinRM itself is fine and the issue is specific to the deploy step.
Enable-PSRemoting), and that the relay trusts it (TrustedHosts, for non-domain targets — see setup above). To isolate the issue from everything else:Install succeeded, but the device never appeared on the dashboard
Install succeeded, but the device never appeared on the dashboard
The file copy and service creation likely worked, but something after that didn’t. On the target, confirm the service is actually running and check its config points at the right server (not
localhost) — the full diagnostic steps are in the agent’s troubleshooting reference.