Installation on Windows

The Zoan Agent is installed along with the rest of the platform (Designer, Runner, Session Capture) using a single installer: Zoan Platform Setup. This page covers detailed installation on Windows, wizard decisions, and how to manage the Windows service that runs the Agent in unattended mode.

Requisitos

Requisito	Detalle
Sistema operativo	Windows 10 (build 1809+) o Windows 11. Windows Server 2016, 2019 o 2022.
Arquitectura	x64 only. ARM64 not supported for now.
Memoria	4 GB minimum. Recommended 8 GB+ if you are going to run several concurrent bots.
Disco	500 MB free for installation. Additional space depends on the packages you download.
Permisos	Local administrator if you want to install the Agent as a service (recommended for servers). Normal user if you only need it for your session.
Red	Acceso saliente al puerto 443 (HTTPS) hacia tu instancia de Zoan Cloud.
Runtime .NET	The installer automatically downloads and installs the.NET 8 Desktop Runtime if it is missing.
WebView2	The installer automatically downloads and installs the Microsoft Edge WebView2 Runtime if it is missing.

Corporate servers with a proxy

If your corporate network requires a proxy to access the Internet, the Agent respects the system’s proxy settings. Make sure the user the service runs under (LocalSystem by default) has access to the proxy or configure an explicit proxy in the advanced options (documented soon).

Download the installer

The file is ZoanPlatformSetup.exe (~80-120 MB). There are three ways to obtain it:

1. From the tenant portal: there is a download link in the header and on each agent page.
2. From the activation email you received when activating your tenant.
3. Ask support: soporte@zoansoftware.com.

The installation wizard

Al ejecutar ZoanPlatformSetup.exe, Windows pregunta si quieres permitir cambios (UAC). Acepta.

Before displaying the wizard, the installer performs two automatic checks:

1. .NET 8 Desktop Runtime — if it is not there, it offers you to download it and installs it in the background.
2. Microsoft Edge WebView2 Runtime — idem.

If you accept both installations, the wizard opens when they are finished. If you decline, the installer closes (it cannot continue without those components).

From here you have 5 steps:

1. Welcome

   Welcome screen with a summary of what the installer does and links to legal terms.

   

   Note

   By installing you accept the Terms of Service and the Privacy Policy.

   Click on Get started.

2. Select components

   Lista de componentes a instalar, todos seleccionados by default:

   Componente	What are you doing	When to uncheck it
   Zoan Designer	Visual IDE to design playbooks.	On servers that only run unattended bots.
   Zoan Agent	Runtime that runs the bots and connects to Zoan Cloud.	On machines that are only used for designing (not running Zoan Cloud bots).
   Zoan Runner	Execution engine. Required for Designer and Agent to work.	Never — Designer and Agent depend on it.
   Session Capture	Utility that records screen during unattended runs (for auditing).	Si no quieres grabaciones.

   

   Click Next.

3. Install location

   Dos decisiones acopladas:

   Scope (scope of installation):

   Option	Detalle	When to choose it
   All users	Install for all Windows users. Requires admin. Register the Agent as Windows service (ZoanAgentService) with automatic startup at boot.	Servers and machines dedicated to running bots unattended 24/7.
   Current user only	Install only for your account. No admin required. The Agent starts at login (entry at HKCU\...\Run), not as a service.	Development teams, shared machines, or when you don’t have admin permissions.

   Destination folder: where the files are copied. By default:

   • All users: C:\Program Files\Zoan\
   • Current user only: C:\Users\<TuUsuario>\AppData\Local\Programs\Zoan\

   You can change it with Browse… if you need to install to another drive or corporate path.

   

   Click Next.

4. Installing

   Progress bar with details of what you are copying. The log at the bottom shows each step:

   Extrayendo Designer...
   Extrayendo Agent...
   Extrayendo Runner...
   Extrayendo Session Capture...
   Creando accesos directos del Designer...
   Creando accesos directos del Agent...
   Configurando inicio automático del Agent...
   Registrando servicio ZoanAgentService...  (solo con All users)
   Iniciando servicio ZoanAgentService...     (solo con All users)

   

   Installation takes 30-90 seconds depending on disk speed.

5. Done

   Confirmation with a green check. The installation created:

   • Shortcuts in the Start menu: Zoan Designer and Zoan Agent.
   • Shortcuts on the Desktop.
   • An entry in Settings → Applications called “Zoan Platform” for future uninstallation.
   • (If you chose All users) the ZoanAgentService service registered and running.
   • (If you chose Current user only) an entry in HKCU\Software\Microsoft\Windows\CurrentVersion\Run that opens the Agent upon login.

   

   Click on Finish. The installer closes.

Connect Agent to Zoan Cloud

Configuring the connection to your Zoan Cloud instance is done from the Agent interface, not by editing files.

1. Open Zoan Agent from the Start menu.

2. “Connect this device” screen

   The first time you are greeted by this screen. It has two fields:

   • Zoan Cloud URL — the URL of your portal (e.g. https://acme.cloud.zoansoftware.com). It must start with https:// and without a trailing slash.
   • Machine Key — the key generated when creating the agent in the portal (UUID format, 36 characters with dashes).

   

3. Paste the values ​​and click on “Connect with Zoan Cloud”

   The Agent contacts Zoan Cloud, validates the Machine Key, and saves the encrypted configuration to disk. If everything goes well, in 2-3 seconds it changes to the main screen with the status pill connected in green.

   

4. Verify from the portal

   Go to environment → Agents. The agent must be listed as online (green badge) and the “Online” counter above must have incremented.

   

Configuration screen requires admin

The “Connect this computer” screen requires that the Agent be opened as administrator to save the settings to a protected location. If you open it as a normal user, the screen is displayed but the button is disabled and you see a warning to reopen as admin. This prevents an unprivileged user from changing the Zoan Cloud connection of a shared machine.

Manage Windows service

When you choose All users during installation, the Agent registers as a service. Useful commands from PowerShell with admin:

# Estado del servicio
Get-Service ZoanAgentService

# Detener
Stop-Service ZoanAgentService

# Iniciar
Start-Service ZoanAgentService

# Reiniciar
Restart-Service ZoanAgentService

# Cambiar a inicio manual (no arranca con Windows)
Set-Service ZoanAgentService -StartupType Manual

# Volver a automático
Set-Service ZoanAgentService -StartupType Automatic

Service logs: C:\ProgramData\Zoan\Agent\logs\service.log — useful for diagnosing problems when the Agent does not appear online for no apparent reason.

Execution modes

The Agent can operate in two modes depending on how it is installed and opened:

Mode	How to activate	Characteristics
Attended	You open Zoan Agent from the desktop or menu. The UI is displayed.	You need a Windows session open. Ideal for automations that require viewing the screen (e.g. captures, monitoring).
Desatendido (servicio)	The ZoanAgentService service runs in the background under the LocalSystem account.	No open session required. Boot with the system. Limitations for UI automations that require an interactive session.

The Zoan Cloud portal can direct executions to both attended and unattended modes, depending on how you configure the processes.

Update Agent

When there is a new version, the Agent can:

• Notify you from the system tray (attended mode) — right click on the icon → Update now.
• Automatically update during a configured maintenance window (coming soon).

Updates are in-place: download the new .exe, verify it, replace the binary and restart the service. It does not require reconfiguring the connection to Zoan Cloud.

Uninstallation

Tres formas:

1. Settings → Applications → Zoan Platform → Uninstall (recommended).
2. Panel de Control → Programas → Zoan Platform → Desinstalar.
3. Run ZoanPlatformSetup.exe --uninstall from a console with admin.

The uninstaller uses a 3-step wizard:

1. Confirm — confirms which components are installed and are being deleted.
2. Removing — barra de progreso. Detiene y desregistra ZoanAgentService, borra accesos directos, elimina archivos.
3. Done — confirmation.

Note

Uninstalling does not delete the operation logs on C:\ProgramData\Zoan\ or the packages installed in the packages directory. Delete them manually if you want a complete cleanup.

Troubleshooting

Symptom	Causa probable	How to solve
The installer does not open	.NET 8 or WebView2 is missing and the download failed	Install manually from dotnet.microsoft.com and developer.microsoft.com/microsoft-edge/webview2
”Access denied” during installation	You chose “All users” without admin	Close and reopen the installer as administrator, or choose “Current user only”
Agent does not appear after installing	You are not looking at the correct menu. In “Current user” it only appears in your user’s Start menu; in “All users” it appears for everyone.	Search for “Zoan Agent” from the Start menu
”Connect to Zoan Cloud” button is disabled	The Agent was opened as a normal user	Close it and reopen it as administrator (right click → Run as administrator)
“No se pudo contactar a Zoan Cloud”	Firewall, proxy, URL incorrecta	Check the URL, try opening it from Edge on the same machine. If there is a corporate proxy, configure the system proxy
The Agent says “connected” but the portal shows it offline	Heartbeat blocked on network	Verify that port 443 is open outbound from the Agent machine to Zoan Cloud. WebSockets also not blocked
ZoanAgentService service does not start	Permisos o cuenta de servicio cambiada	Get-EventLog -LogName System -Newest 20 to view the specific error

If none of the above resolves, check C:\ProgramData\Zoan\Agent\logs\service.log (service mode) or C:\Users\<TuUsuario>\AppData\Local\Zoan\Agent\logs\ (attended mode) and contact us at soporte@zoansoftware.com with the last 50 lines of the log.