> For the complete documentation index, see [llms.txt](https://docs.we360.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.we360.ai/deployment-and-it-ops/deploy/agent-deployment-hub/manual-installation/linux-installation.md).

# Linux Installation

Install the We360.ai MyZen agent on Linux (Ubuntu) — Stealth-mode employee monitoring software installation guide.

On Linux, the We360.ai agent is deployed in **Stealth mode** using a shell installer. It runs silently in the background with no user interface, following your organization's tracking policies.

{% hint style="info" %}
Standard (visible) mode is available on Windows and macOS. On Linux, the agent is distributed as a headless Stealth installer intended for IT-managed rollouts.
{% endhint %}

## Prerequisites

| Requirement       | Detail                                                                                                                                                                                       |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Distribution**  | Ubuntu (64-bit / x86‑64). Other Debian-based distributions may work but Ubuntu is the supported target.                                                                                      |
| **Privileges**    | Root / `sudo` access is required to install the background service.                                                                                                                          |
| **Antivirus/EDR** | Add an exception for the agent if endpoint protection is active (see [AV and EDR Exclusions](/deployment-and-it-ops/security-hardening/network-security-hardening/av-and-edr-exclusions.md)) |
| **Network**       | Outbound HTTPS/WSS on TCP 443 to the We360.ai endpoints (see [The "Allowlist" Guide](/deployment-and-it-ops/security-hardening/network-security-hardening/allowlist-guide.md))               |

## Download the Installer

1. Log in to the We360.ai web portal, or use the [Download Links & Utilities](/deployment-and-it-ops/deploy/agent-deployment-hub/download-links.md) page.
2. Download the Linux Stealth installer: `zs-amd64.sh`.

{% hint style="warning" %}
Before running it, **rename the installer to your Stealth license key**, keeping the `.sh` extension — for example `A1B2C3D4.sh`. The installer reads the tenant binding from its own filename, so do not run it under the generic `zs-amd64.sh` name.
{% endhint %}

## Install

Open a terminal in the folder containing the renamed installer and run:

{% code title="Terminal" %}

```bash
chmod +x <stealth_license_key>.sh
sudo ./<stealth_license_key>.sh
```

{% endcode %}

The script installs the agent and registers a background service that starts automatically and survives reboots. No further interaction is required — there is no window or tray icon in Stealth mode.

## Validate the Installation

Because Stealth mode is invisible on the device, confirm success from the **server side**:

1. Wait a few minutes after installation.
2. In the We360.ai portal, open the **Devices** view (or the user's detail page).
3. Confirm the Linux device appears and is reporting recent activity.

If no data arrives, review the [Tracker Failure Diagnostic Guide](/deployment-and-it-ops/troubleshoot-support/tracker-failure-guide.md) and verify network reachability and AV/EDR exclusions.

## Offline / Firewalled Environments

If the device cannot reach the discovery endpoint, IT can pre-provision service discovery with a protected `zs-origin.json` manifest at `/etc/`. See [Pre-Provisioned Origin Data](/deployment-and-it-ops/security-hardening/network-security-hardening/pre-provisioned-origin-data.md).

## Uninstall

Use the **Zen Cleanup Utility** for Linux to fully remove the agent. Download it from [Download Links & Utilities](/deployment-and-it-ops/deploy/agent-deployment-hub/download-links.md) (`zen_cleanup`, available for `amd64` and `arm64`), then run it with `sudo`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.we360.ai/deployment-and-it-ops/deploy/agent-deployment-hub/manual-installation/linux-installation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.