# Agent

The ThinRemote Agent is the lightweight service that connects your devices to the ThinRemote cloud. It runs as a background process on your system, creating a secure bridge between your hardware and your ThinRemote console or CLI.

With the Agent installed, you can instantly access your device remotely — no VPNs, no open ports, and no firewall changes required.

***

### Key Features

* **Lightweight:** <10MB static binary, minimal RAM usage (<15MB).
* **Universal:** Runs on Linux kernel 2.6+ across x86\_64, ARM (v6/v7/v8), ARM64, MIPS, i386, and more.
* **Zero Dependencies:** Requires no external libraries.
* **Secure Gateway:** Outbound-only TLS 1.3 connections, no inbound ports exposed.
* **Always Connected:** Automatic reconnection and health monitoring keep devices online.
* **System Integration:** Executes commands, manages processes, and provides access to system resources.

***

### Installation

You can deploy the Agent on any supported Linux system in seconds.

#### One-Line Installation

```bash
curl -fsSL https://get.thinremote.io/install.sh | sh
```

The installer automatically detects your architecture, downloads the correct binary, and configures the Agent as a system service.

#### Manual Installation

1. Download the binary for your architecture.
2. Copy it to your device and set execute permissions.
3. Run it manually or configure it as a service.

#### Automated Deployment

The Agent can be provisioned with scripts or configuration management tools (Ansible, Puppet, Chef, etc.), making it easy to deploy across large fleets.

***

### Supported Platforms

* **Embedded & IoT:** Raspberry Pi (all models), industrial PLCs, digital signage, kiosks.
* **Networking:** Routers (OpenWRT, DD-WRT), firewalls (pfSense, OPNsense).
* **Servers & VMs:** Linux servers, NAS devices, VMware, KVM, Xen.
* **Cloud:** AWS EC2, Azure VMs, Google Cloud Compute Engine.
* **Containers:** Docker, LXC, Kubernetes.

If it runs Linux 2.6 or newer, it runs ThinRemote.

***

### Verifying Installation

After installation, check the service status:

```bash
systemctl status thin-remote
```

You should see the Agent running and connected. The device will also appear in your ThinRemote web console.

***

### Next Steps

Once the Agent is installed and online, you can:

* Open an SSH session through the ThinRemote CLI or web console.
* Tunnel local web services securely to your browser.
* Monitor system metrics in real-time.
* Transfer files between your device and the cloud.


---

# Agent Instructions: 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:

```
GET https://docs.thinremote.io/product-guides/agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.