Deploy Your First Agent

Before installing the agent, ensure you have:

• A 24zero account with an active subscription
• Your API key (found in Settings → API Keys)
• Administrative/root access on the target device
• Internet connectivity to 24zero.cloud

The fastest way to install the agent is using our one-line installer. This automatically detects your platform and installs the appropriate agent.

# Universal installer (detects platform automatically)
curl -fsSL https://get.24zero.cloud/install.sh | bash -s -- --api-key YOUR_API_KEY

For more control, use the platform-specific installation guides:

• macOS Installation Guide
• Windows Installation Guide
• Linux Installation Guide

After installation, verify the agent is running:

# Check agent status
24zero-agent status

# Expected output:
# Agent Status: Running
# Connected: Yes
# Last Check-in: Just now

You should also see the device appear in your dashboard under Devices within a few minutes.

If the agent doesn't connect:

1. Verify your API key is correct
2. Check that outbound HTTPS (port 443) is allowed
3. Ensure the agent service is running
4. Check the agent logs for errors

# View agent logs
# macOS/Linux
tail -f /var/log/24zero-agent.log

# Windows
Get-Content "C:\ProgramData\24zero\logs\agent.log" -Tail 50

Once your agent is connected:

• Run your first security scan
• Configure device policies
• Set up automated scanning schedules
• Deploy agents to additional devices