Ctrlk

Agent

The ThinRemote Agent is a lightweight, zero-dependency service that securely connects any Linux device to the cloud.

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

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:

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.

PreviousOur FeaturesNextCLI

Last updated