Deployment

Hosted Nexus integration and deployment models

Deployment

Nexus is available as a hosted platform with optional dedicated and private cloud deployment for enterprise tenants.

Hosted endpoints

Integrator checklist

  1. Create API keys at developers.hardalion.com (hdl_test_ then hdl_live_)
  2. Configure CORS allowlists if calling from browser clients
  3. Wrap agents with @hardalion/sdk or call /v1 routes per OpenAPI
  4. Run shadow mode before enforce mode in production
  5. Evaluate policies locally with NPL Quickstart in CI

Health checks

curl https://nexus.hardalion.com/api/health
curl https://api.hardalion.com/api/health
# → {"status":"ok","version":"0.11.0"}

Deployment models

ModelBest for
Multi-tenant SaaSFastest time to value, sandbox to production
Dedicated tenantIsolated Postgres, configurable data residency (EU, UK, US)
Private cloudAir-gapped or on-premise under enterprise agreement

Contact hardalion.com for dedicated and private cloud provisioning.

NPL-only CI gate

No Nexus subscription required for policy validation in CI:

npx @hardalion/npl-policy-engine --tool drop_table --json
# exit 1 = BLOCK (fail build if policy violated)

Or npm install @hardalion/npl-policy-engine in your agent service.

SDK deployment

import { NexusGateway } from '@hardalion/sdk'

const agent = NexusGateway.wrap(rawAgent, {
  tenantId: process.env.HARDALION_TENANT_ID!,
  agentId: process.env.HARDALION_AGENT_ID!,
  apiKey: process.env.HARDALION_API_KEY!,
  baseUrl: 'https://api.hardalion.com',
  policy: 'hardalion://nato-prou-strict-financial@1.0.0',
})

See Environment variables for client configuration.