Install the Task Mining Portable Windows agent

task australia Updated Sep 10, 2026 1 min read install-task-mining-portable-agent.md

Run the Task Mining agent from a portable archive without installing it on the system. The portable agent does not modify the Windows registry or write files outside its extracted folder.

Before you begin

Role required: Task Mining Agent Install

Note: You must be a part of the Task Mining Agent Install group with roles itil, sn_tm_core.service_user, and agent_client_collector_admin to install the Task Mining agent. If the group doesn't exist, create a group with that name and those roles manually. For more information, see Assign a role to a group.

Procedure

Extract the ZIP and copy the Instance URL and Registration key.
1. Navigate to All > Task Mining > System Settings > Agent Installation.
2. Select an existing key or create one.
  
  [Omitted image "tm-agent-3.png"] Alt text: A registration key selection.
3. Select the Portable Windows agent tab.
4. Extract the ZIP archive to any folder, for example C:\Tools\TM-Agent-Portable.
5. Copy the Instance URL and Registration key on the Agent Installation page.
[Omitted image "tm-agent-5.png"] Alt text: A portable windows agent download screen.
Run PortableLauncher.exe from the extracted folder.

PortableLauncher.exe starts the agent executable (tm-agent-winui.exe) from the Bin directory. If tm-agent-winui.exe exits unexpectedly or restarts itself, the launcher restarts automatically.

On the first run, a registration dialog appears.
Register the agent with your ServiceNow instance.
1. Enter the ServiceNow instance URL (copied from the Agent Installation page).
2. Enter the registration key (copied from the Agent Installation page).
3. Select Register.
After successful registration, the agent starts normally. This can take up to 30 seconds. Once running, the agent icon appears in the Windows system tray (notification area).

What to do next

If you encounter issues, check the logs in the Bin\log directory within the extracted folder.

64 lines · 2.9 KB Wrap lines

---
title: Install the Task Mining Portable Windows agent
description: Run the Task Mining agent from a portable archive without installing it on the system. The portable agent does not modify the Windows registry or write files outside its extracted folder.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/application-development/task-mining/install-task-mining-portable-agent.html
release: australia
product: Task Mining
classification: task-mining
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Install the Task Mining agent, Configure, Task Mining, Discover, AI Workflow Factory Prime, Agentic app development, Building applications]
---

# Install the Task Mining Portable Windows agent

Run the Task Mining agent from a portable archive without installing it on the system. The portable agent does not modify the Windows registry or write files outside its extracted folder.

## Before you begin

Role required: Task Mining Agent Install

**Note:** You must be a part of the Task Mining Agent Install group with roles itil, sn\_tm\_core.service\_user, and agent\_client\_collector\_admin to install the Task Mining agent. If the group doesn't exist, create a group with that name and those roles manually. For more information, see [Assign a role to a group](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/t_AssignRoleToGroup.md).

## Procedure

1. Extract the `ZIP` and copy the **Instance URL** and **Registration key**.

1. Navigate to **All** &gt; **Task Mining** &gt; **System Settings** &gt; **Agent Installation**.

2. Select an existing key or create one.

\[Omitted image "tm-agent-3.png"\] Alt text: A registration key selection.

3. Select the Portable Windows agent tab.

4. Extract the `ZIP` archive to any folder, for example `C:\Tools\TM-Agent-Portable`.

5. Copy the **Instance URL** and **Registration key** on the Agent Installation page.

\[Omitted image "tm-agent-5.png"\] Alt text: A portable windows agent download screen.

2. Run `PortableLauncher.exe` from the extracted folder.

`PortableLauncher.exe` starts the agent executable \(`tm-agent-winui.exe`\) from the `Bin` directory. If `tm-agent-winui.exe` exits unexpectedly or restarts itself, the launcher restarts automatically.

On the first run, a registration dialog appears.

3. Register the agent with your ServiceNow instance.

1. Enter the ServiceNow instance URL \(copied from the Agent Installation page\).

2. Enter the registration key \(copied from the Agent Installation page\).

3. Select **Register**.

After successful registration, the agent starts normally. This can take up to 30 seconds. Once running, the agent icon appears in the Windows system tray \(notification area\).

## What to do next

If you encounter issues, check the logs in the `Bin\log` directory within the extracted folder.