Agent Installation

Agent Installation

Install the SSH-KLM agent on target hosts for full key management capabilities.

Installation Methods

Quick Install (Recommended)

curl -fsSL https://get.qcecuring.com/ssh-agent | sudo bash -s -- \
  --server https://ssh-klm.example.com \
  --token YOUR_REGISTRATION_TOKEN

Package Manager

Ubuntu/Debian:

# Add repository
curl -fsSL https://packages.qcecuring.com/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/qcecuring.gpg
echo "deb [signed-by=/usr/share/keyrings/qcecuring.gpg] https://packages.qcecuring.com/apt stable main" | \
  sudo tee /etc/apt/sources.list.d/qcecuring.list

# Install
sudo apt update
sudo apt install ssh-klm-agent

# Configure
sudo ssh-klm-agent configure \
  --server https://ssh-klm.example.com \
  --token YOUR_TOKEN

RHEL/CentOS:

# Add repository
sudo dnf config-manager --add-repo https://packages.qcecuring.com/rpm/qcecuring.repo

# Install
sudo dnf install ssh-klm-agent

# Configure
sudo ssh-klm-agent configure \
  --server https://ssh-klm.example.com \
  --token YOUR_TOKEN

Docker

docker run -d \
  --name ssh-klm-agent \
  --restart unless-stopped \
  -v /etc/ssh:/etc/ssh:rw \
  -v /home:/home:rw \
  -v /root:/root:rw \
  -e SSHKLM_SERVER=https://ssh-klm.example.com \
  -e SSHKLM_TOKEN=YOUR_TOKEN \
  qcecuring/ssh-klm-agent:latest

Ansible

- name: Install SSH-KLM Agent
  hosts: all
  roles:
    - role: qcecuring.ssh_klm_agent
      vars:
        sshklm_server: https://ssh-klm.example.com
        sshklm_token: "{{ vault_sshklm_token }}"

Verification

# Check service status
sudo systemctl status ssh-klm-agent

# Verify connectivity
sudo ssh-klm-agent status

# View logs
sudo journalctl -u ssh-klm-agent -f

Registration Token

Generate a token in the UI:

1. Go to Settings → Agents
2. Click Generate Registration Token
3. Set expiry and host limit
4. Copy token for installation

Firewall Requirements

Direction	Port	Protocol	Purpose
Outbound	443	HTTPS	API communication
Outbound	8443	gRPC	Agent streaming

Related Pages

• Agent Configuration
• Agent Troubleshooting