Skip to main content

Windows Installation

Complete guide for installing the CastellanAI Agent on Windows.

Quick Install

For most users, the interactive installer is the fastest way to get started. Just download, run as Administrator, and enter your credentials.

Prerequisites​

Before installing, ensure you have:

  • Windows 10 (version 1809 or later) or Windows Server 2019+
  • Administrator privileges
  • Network access to Worker API (outbound HTTPS on port 443)

Download​

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

Installation Methods​

Interactive Installer​

The easiest method for individual installations.

  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
Run as Administrator

Right-click the installer and select "Run as administrator" to ensure proper installation.

Configuration​

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

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

The configuration file contains sensitive credentials. Ensure it has appropriate file system permissions (readable only by SYSTEM and Administrators).

Verify Installation​

# Check service status
Get-Service CastellanAgent

# Expected output:
# Status   Name           DisplayName
# ------   ----           -----------
# Running  CastellanAgent CastellanAI Agent

Uninstallation​

🗑️ How to Uninstall
# Stop and remove service
sc.exe stop CastellanAgent
sc.exe delete CastellanAgent

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

# Remove log directory (optional)
Remove-Item "$env:LOCALAPPDATA\CastellanAgent" -Recurse -Force

Or use Add/Remove Programs in Windows Settings if installed via the interactive installer.

Troubleshooting​

❌ Service won't start
  1. Check Event Viewer for error messages
  2. Verify configuration file exists and has valid JSON
  3. Run manually to see errors: 
    & "C:\Program Files\CastellanAgent\Castellan.Agent.exe"
🔌 Agent not appearing in Portal
  1. Check service is running: Get-Service CastellanAgent
  2. Test network connectivity: 
    Test-NetConnection -ComputerName api.castellanai.com -Port 443
  3. Verify credentials in appsettings.json
🛡️ Antivirus blocking installation

Add these paths to your antivirus exclusions:

  • C:\Program Files\CastellanAgent\
  • %LOCALAPPDATA%\CastellanAgent\

What's Next?​

GuideDescription
ConfigurationAdvanced agent configuration options
Health MonitoringMonitor agent status and performance
TroubleshootingResolve common issues
Need Help?

See Common Issues for help with installation problems.