Skip to main content
The Miru Agent is a lightweight systemd service that runs on your machines, handling the deployment lifecycle of configurations. The agent offers the following functionality:
  • Syncs configurations from the cloud to the local filesystem in real-time
  • Manages device state, providing real-time updates of the device’s status and the currently deployed configurations
  • Exposes a local REST API with event streaming over a Unix socket for programmatic access by applications running on the same machine

Key benefits

The Miru Agent offers the following key benefits:
  • Offline resilience - configurations are cached locally on the machine and synced as soon as the network is available, ensuring continued operation through network interruptions
  • Secure communication - all communication is outbound-only via HTTPS or MQTT over TLS, ensuring secure and private communication
  • Lightweight footprint - our rust-based agent consumes minimal resources and may be configured to only run on demand (via socket activation) for further optimization
  • Open-source - the agent is open-source and available on GitHub

REST API

Applications running on the same machine as the Miru Agent can access it via the agent’s Device API. Use it to fetch the currently deployed configurations, trigger a manual sync, check the agent’s status, or read device metadata—without round-tripping to the cloud. In addition to request/response endpoints, the Miru Agent exposes a Server-Sent Events (SSE) stream that pushes notifications to your application in real time.

Device API

Learn more about the Device API for programmatic access to the Miru Agent.

Supported platforms

The Miru Agent only supports Linux. MacOS and Windows are not supported. The following operating systems are tested and verified to work with the Miru Agent:
  • Ubuntu 20.04, 22.04, and 24.04 LTS
  • NVIDIA Jetson JetPack 5.1 and JetPack 6.1
  • Raspberry Pi OS (64-bit)
Other Linux distributions and versions may also work, but have not been explicitly tested.
Last modified on April 10, 2026