Skip to main content

Agent

The HexDroid CI Agent is a core component that handles pipeline execution in the CI/CD workflow.

It establishes a secure HTTPS connection with the HexDroid master server for communication and task management.

The agent:

  • Receives and executes CI/CD pipeline jobs
  • Reports execution status and results back to the master server
  • Manages local build environments and resources
  • Ensures secure and isolated execution of pipeline tasks

Multiple agents can be configured to distribute workload and enable parallel execution of CI/CD tasks.

Deployment Options​

HexDroid provides two flexible deployment options for CI agents:

Managed Agents​

HexDroid offers fully managed agents that are maintained and operated by our team.

These agents provide:

  • Zero maintenance overhead
  • Automatic updates and security patches
  • Optimized for build performance
  • Datacenter networking with high-speed, low-latency connectivity for faster fetch times and optimal data transfer
  • On request HexDroid managed agents can be connected to your internal network via VPN.
tip

To enable managed agents for your project, please reach out to our support team at support@hexdroid.com and we'll activate them for your account.

Self-hosted Agents​

Organizations can deploy and manage HexDroid agents on their own infrastructure:

  • Full control over the execution environment
  • Support for custom security policies
  • Integration with internal networks and resources
  • On-premises or cloud deployment flexibility

Self-hosted Deployment​

System requirements:

  • Linux-based operating system.
  • Docker Engine. Refer to docker.com for instructions for installation.
Docker compose​

Latest version can be found here: https://github.com/HexDroidApp/ci-agent/pkgs/container/ci-agent%2Fci_agent

services:
  runner:
    restart: unless-stopped
    image: ghcr.io/hexdroidapp/ci-agent/ci_agent:0.0.2
    command:
      - "agent"
    environment:
      HEXDROID_API_KEY: "API_KEY_HERE"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
Executable​

You can download the HexDroid CI Agent packaged binary from: https://github.com/HexDroidApp/ci-agent/releases

Then run:

HEXDROID_API_KEY=API_KEY_HERE java -jar hexdroid-ci-agent.jar agent