Skip to main content

Windows Installation

Complete guide for installing the CastellanAI Agent on Windows.

Prerequisites​

  • Windows 10 (version 1809 or later) or Windows Server 2019+
  • Administrator privileges
  • Network access to Worker API

Download​

  1. Log in to the Customer Portal
  2. Navigate to Agents → Download
  3. Select Windows and download the installer

Installation Methods​

Interactive Installer​

  1. Run CastellanAgent-Setup.exe as Administrator
  2. Follow the installation wizard
  3. Enter your Customer ID when prompted
  4. Enter the Hub URL (Worker API endpoint)
  5. Click Install

Silent Installation​

For automated deployments:

CastellanAgent-Setup.exe /S /CUSTOMERID="your-customer-id" /HUBURL="https://api.castellanai.com/hubs/agent-communication"

Manual Service Installation​

# Copy agent files to installation directory
$installDir = "C:\Program Files\CastellanAgent"
New-Item -ItemType Directory -Path $installDir -Force

# Install as Windows Service
sc.exe create "CastellanAgent" binPath="$installDir\Castellan.Agent.exe"
sc.exe config "CastellanAgent" start=auto
sc.exe start "CastellanAgent"

Configuration​

Configuration file location: C:\Program Files\CastellanAgent\appsettings.json

{
  "AgentSettings": {
    "CustomerId": "your-customer-id",
    "HubUrl": "https://api.castellanai.com/hubs/agent-communication"
  }
}

Verify Installation​

# Check service status
Get-Service CastellanAgent

# View recent logs
Get-Content "$env:LOCALAPPDATA\CastellanAgent\logs\*.log" -Tail 50

Uninstallation​

# Stop and remove service
sc.exe stop CastellanAgent
sc.exe delete CastellanAgent

# Remove installation directory
Remove-Item "C:\Program Files\CastellanAgent" -Recurse -Force

Troubleshooting​

See Common Issues for help with installation problems.