Skip to main content
What the agent is, what it does, how installation and updates work, and where things live on disk. Written for anyone installing or supporting the agent — IT admins, not just developers.

​
What is the AssetGullak Agent?

The AssetGullak Agent is a small background program that runs on your company’s computers (Windows, macOS, or Linux) and reports device health, installed software, and status back to your AssetGullak dashboard. It also lets your IT admins run remote actions — restart a device, collect logs, run a script — without needing physical or remote-desktop access to the machine. It runs continuously as a system service, starting automatically when the computer boots, and requires no ongoing attention once installed.

​
What it does

  • Device inventory — hostname, OS version, hardware specs, IP address
  • Real-time metrics — CPU, RAM, and disk usage
  • Software inventory — a list of installed applications, refreshed periodically
  • Remote commands — restart, shutdown, collect logs, run a script, refresh inventory, or update the agent itself, all triggered from your dashboard
  • Automatic updates — when your admin pushes a new agent version, it downloads, verifies, and applies it automatically, then restarts itself

​
What it does NOT do

  • It does not read personal files, browsing history, or private data
  • It does not run anything unless your IT admin explicitly triggers it from the dashboard
  • It does not phone home to anywhere except your company’s AssetGullak backend

​
Supported platforms

OSSupportedInstall method
Windows 10/11✅Standard installer, or pushed remotely via Bulk Deploy
macOS✅Standard installer
Linux✅Standard installer (systemd-based distros)

​
Installing the agent

​
Standard install (any platform)

  1. Go to Devices → Add → Download agent in your AssetGullak dashboard
  2. Pick your operating system and download the installer
  3. Run the install command shown on that page — it already includes your company’s enrollment key, so you shouldn’t need to type or paste anything else
The exact command looks like this (Windows example): 
.\AssetGullak.exe --install --enrollment-key <your-company-key>
On macOS/Linux, this needs to run with elevated privileges: 
sudo ./AssetGullak --install --enrollment-key <your-company-key>
What happens during install:
  1. The agent registers itself as a system service (Windows Service / launchd daemon / systemd unit) so it starts automatically on boot
  2. It contacts your AssetGullak backend using the enrollment key to identify itself and receive a permanent device credential
  3. The enrollment key is used once and then discarded — after that, the device has its own unique identity
  4. The device appears in your dashboard, usually within a few seconds

​
Bulk deployment (Windows only, v1)

If you’re onboarding many Windows devices on the same network at once, use Devices → Add → Deploy to network instead of installing manually on each machine. This lets an already-enrolled device scan your network and push the installer to others automatically. See the separate Deploy to Network — Requirements & Troubleshooting guide for setup details.

​
Uninstalling

# Windows (as Administrator)
.\AssetGullak.exe --uninstall

# macOS / Linux
sudo ./AssetGullak --uninstall
This removes the system service registration. It deliberately does not delete the agent’s configuration or logs — this way, reinstalling later doesn’t require re-enrolling from scratch. To fully remove all traces, also delete the data directory for your platform (see table below).

​
Automatic updates

When your admin pushes a new version from the dashboard (Devices → [any device] → Run command → Update agent, or in bulk across many devices), the agent will:
  1. Download the new version
  2. Verify its integrity (checksum) before doing anything else
  3. Replace itself with the new version
  4. Restart automatically — this takes a few seconds, during which the device will briefly show as offline before reconnecting
You don’t need to do anything for this to happen — it’s fully automatic once triggered from the dashboard. The agent never updates itself on a timer or without being explicitly told to.

​
Where things live on disk

WindowsmacOSLinux
Program filesC:\Program Files\AssetGullak\/Applications/AssetGullak (or wherever installed)/usr/local/bin/AssetGullak (or wherever installed)
ConfigurationC:\ProgramData\AssetGullak\config.toml/Library/Application Support/AssetGullak/config.toml/etc/assetgullak/config.toml
LogsC:\ProgramData\AssetGullak\logs\/Library/Logs/AssetGullak//var/log/assetgullak/
Service managerWindows Service Control Managerlaunchdsystemd
Logs rotate daily and are named by date (e.g. agent.log.2026-07-05).

​
Permissions the agent needs

The agent runs with elevated system privileges (Administrator / root) on all platforms. This is required because it needs to:
  • Read hardware and OS information not visible to a standard user account
  • Execute remote commands like restart/shutdown
  • Register itself as a boot-time system service
It does not need — and never requests — access to personal user accounts, files outside its own installation folder, or browser data.

​
Frequently asked questions

Does uninstalling remove my device from the dashboard? No — the device record stays in your dashboard, just shown as offline. If you want it removed entirely, delete the device from the dashboard separately. What happens if the agent loses network connectivity? It keeps running normally and retries reporting to the backend automatically once connectivity returns. No data about the device itself is lost during an outage — you’ll just see a gap in metrics history for that period. Can I run more than one agent per device? No — the installer will refuse to install if it detects the service is already registered on that machine. Is the executable signed? Not yet in the current release — this means Windows SmartScreen or your antivirus may show a warning the first time you run it. This is expected for now; the file is safe. Signing is planned for a future release. Where can I see what changed in a new version? Release notes are shown on the Download agent page alongside each version.