Installing as a Docker or Podman container

The Remote Ops Agent can be deployed as a Docker container, providing a standardized deployment option across different operating systems and environments.

Note: Remote Ops Agent supports both Docker Engine 20.10+ with Compose V2 and Podman 4.4+ with podman compose. The procedures in this guide show docker and docker compose commands; substitute podman and podman compose to use Podman. The shipped docker-compose.yml requires no modification.

You need the following files to complete the installation:

hro-agent-version.tar.gz - Docker image
docker-compose.yml - Container configuration
Dockerfile.certs – (Optional) For extending the base image with custom certificates
LICENSE.txt – End User License Agreement

Copy hro-agent-version.tar.gz to the target system.
Extract the package contents to a working folder.
Load the Docker image:
```
docker load -i hro-agent-version.tar.gz
```
Verify that the image loaded successfully:
```
docker images | grep hro-agent
```
Ensure port 6695 is available on the host system:
```
sudo lsof -i :6695
```
Note: Port 6695 is required and cannot be changed. If the port is in use, stop the conflicting service before proceeding.
Start the container:
```
docker compose up -d
```
Wait approximately 30 seconds for the container to initialize, then verify it is running. The container status should show healthy after the startup period.
```
docker compose ps
```
After installing the application, allow five minutes before opening the agent web interface in a browser at https://server_IP:6695 or https://server_IP:6695.
Follow the instructions to accept the EULA, provide the Site ID, and create the initial admin account.