Fleet & Inventories•5 min read•Essential

Adding Servers (Hosts)

Register Linux, Windows, and network targets into CIEL using IP addresses, custom SSH ports, and encrypted credentials.

Before CIEL can automate your infrastructure, you need to register your target servers (referred to as Hosts).

In CIEL, a Host represents any physical server, cloud VPS, virtual machine, or network switch reachable via SSH or WinRM. Target servers remain 100% agentless: you never need to install background daemons on remote machines.

Project Hosts Management Workspace, Capacity Telemetry, and Fleet Table View

1. Fleet Overview & Capacity Telemetry

The Hosts workspace provides high-level fleet operational status via top metric cards:

  • Total Hosts: Total server endpoints registered in the current project workspace.
  • Enabled: Number of operational hosts currently active for task execution.
  • SSH Key Assigned: Servers linked with managed private keys from the Key Vault.
  • Capacity (License Tier): Real-time quota headroom tracking current host usage against your license tier (e.g. Community edition limits or Enterprise unlimited capacity).

2. Registering a New Host

  1. Navigate to Hosts (/hosts) in the project sidebar.
  2. Click the + Add host button in the top action toolbar.
  3. Configure the target connection parameters:
    • Host Name / Identifier: Unique name for the host (e.g. prod-api-01, prod-db-primary).
    • Network Address: Target IPv4, IPv6, or internal DNS hostname (e.g. 10.10.10.21, app.internal.net).
    • Connection Port: Standard SSH port 22, custom SSH port (e.g. 2222), or WinRM HTTPS port 5986.
    • Authentication:
      • SSH Key Pair (Recommended): Select an existing private key from your Key Vault or generate an Ed25519 key on the fly.
      • Password / Secret: Plaintext passwords are automatically encrypted at rest using AES-256-GCM.
    • SSH Username: Remote user account (e.g. ubuntu, debian, root, or Administrator).
    • Privilege Escalation (Sudo): Enable Become (Sudo) if playbooks require root privileges, with an optional sudo password or passwordless sudo.
  4. Click Save Host.

3. Fleet Organization, Folders & Labels

  • Table & Grid Views: Toggle between compact Table View (multi-select, connection latency, endpoint strings, labels) and visual Grid Cards View.
  • Folders: Click + New Folder to categorize hosts into directory paths (e.g. production/web, staging/databases).
  • Labels & Tags: Attach key-value metadata pairs (e.g. env: production, tier: backend, role: controller) to filter and target nodes dynamically during playbook execution.
  • Search & Filter: Search instantly by hostname, IP address, folder, or label. Use status pills (All, Enabled, Disabled) or tag dropdowns for quick fleet filtering.
  • Batch Generator: Use the Generate hosts tool to bulk scaffold multiple sequential nodes (e.g. worker-01 through worker-20).

4. Connectivity Verification & Direct Web SSH

  • Live Health Status: The Connection column displays real-time reachability:
    • [OK] SSH Ready <latency>ms: Verified SSH handshake with round-trip response time and last verification timestamp.
    • [INFO] Untested: Newly registered host pending diagnostic validation.
  • Connection Test Probe: Click the connection badge to trigger an isolated test probe verifying SSH credentials, Python interpreter availability, and remote OS distribution.
  • Direct Web SSH Terminal: Click the >_ SSH button on any host row to open an interactive, zero-install web SSH terminal session directly inside your browser.

5. External References

For remote host administration and protocol specifications: