> 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/deployment/agent-deployment-hub/manual-installation/linux-installation.md).

# Linux Installation

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-and-hardening/network-and-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-and-hardening/network-and-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/deployment/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/troubleshooting-and-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-and-hardening/network-and-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/deployment/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.