Skip to main content

Linux Installation

Complete guide for installing the CastellanAI Agent on Linux.

Prerequisites​

  • Ubuntu 20.04+, Debian 11+, RHEL 8+, or CentOS Stream 8+
  • Root or sudo access
  • Network access to Worker API

Download​

  1. Log in to the Customer Portal
  2. Navigate to Agents → Download
  3. Select your distribution (.deb or .rpm)

Installation​

Debian/Ubuntu​

sudo dpkg -i castellan-agent_1.0.0_amd64.deb

RHEL/CentOS​

sudo rpm -i castellan-agent-1.0.0.x86_64.rpm

Configuration​

Edit the configuration file:

sudo nano /etc/castellan-agent/appsettings.json
{
  "AgentSettings": {
    "CustomerId": "your-customer-id",
    "HubUrl": "https://api.castellanai.com/hubs/agent-communication"
  }
}

Start the Service​

sudo systemctl enable castellan-agent
sudo systemctl start castellan-agent

Verify Installation​

# Check service status
sudo systemctl status castellan-agent

# View logs
sudo journalctl -u castellan-agent -f

Uninstallation​

Debian/Ubuntu​

sudo dpkg -r castellan-agent

RHEL/CentOS​

sudo rpm -e castellan-agent