📦 Agent Installation & Setup

Deploy the CyberVault agent on your endpoints to enable real-time threat detection and compliance monitoring.

Prerequisites

Ensure your environment meets the following requirements before proceeding.

Installation Methods

Select your operating system to view the appropriate installation instructions.

curl -fsSL https://install.cybervault.ai | sudo bash -s -- --edition=enterprise

# Add the CyberVault repository
wget -qO - https://repos.cybervault.ai/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/cybervault-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/cybervault-archive-keyring.gpg] https://repos.cybervault.ai/apt stable main" | sudo tee /etc/apt/sources.list.d/cybervault.list

# Install the agent
sudo apt update
sudo apt install cybervault-agent

# Add the CyberVault repository
sudo yum-config-manager --add-repo https://repos.cybervault.ai/yum/cybervault.repo

# Install the agent
sudo yum install cybervault-agent

# Download the installer
Invoke-WebRequest -Uri https://install.cybervault.ai/windows/latest.msi -OutFile cybervault-agent.msi

# Install with silent flags
msiexec /i cybervault-agent.msi /quiet /norestart LICENSE_KEY="YOUR_LICENSE_KEY"

choco install cybervault-agent --version 2.4.1

brew tap cybervault/agent
brew install cybervault-agent

curl -O https://install.cybervault.ai/macos/latest.pkg
sudo installer -pkg latest.pkg -target /

Initial Configuration

After installation, configure the agent with your license key and connect it to your SOC endpoint.

Set License Key

sudo cybervault config set --license-key "YOUR_LICENSE_KEY"

# Verify license
cybervault license status

Configure SOC Endpoint

By default, the agent connects to us-east-1.soc.cybervault.ai. To use a custom or on-premise endpoint:

sudo cybervault config set --soc-endpoint "https://soc.yourcompany.internal:8443"

# Optional: Specify tenant ID for multi-tenant setups
cybervault config set --tenant-id "YOUR_TENANT_ID"

Verification & Health Check

Confirm the agent is running and communicating with the CyberVault SOC.

$ sudo cybervault status

🛡️ CyberVault Agent v2.4.1
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Status:        ✅ Active
License:       Enterprise (Valid until 2026-01-01)
SOC Endpoint:  us-east-1.soc.cybervault.ai
Connection:    🔗 Connected (12ms latency)
Kernel Module: ✅ Loaded
Monitoring:    4,281 processes tracked
Threats:       0 detected
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

$ sudo cybervault health

✅ All systems operational
   • Kernel integrity: Verified
   • Agent service: Running
   • Data pipeline: Flowing
   • Policy engine: Active

Troubleshooting

Common Issues

• •
  Connection Refused: Verify firewall rules allow outbound TCP/443 to the SOC endpoint. Check proxy settings if applicable.
• •
  Kernel Module Failed: Ensure kernel headers are installed (sudo apt install linux-headers-$(uname -r)) and reboot the system.
• •
  Permission Denied: Run commands with sudo. Ensure the user is in the sudoers group.
• •
  High CPU Usage: The agent performs an initial baseline scan on first run. This should settle within 5 minutes. If persistent, run cybervault logs --level debug.

Viewing Logs

Access detailed agent logs for debugging:

# View last 50 lines
sudo cybervault logs --tail 50

# Stream live logs
sudo cybervault logs --follow

# Export logs for support
cybervault support export --destination /tmp/cyber-dump.tar.gz

Next Steps

After successful installation:

• ✓
  Configure security policies tailored to your workload.
• ✓
  Set up alert rules and notification channels.
• ✓
  Review the SOC Dashboard to see your new endpoint.
• ✓
  Scale deployment using API automation or configuration management tools.