Odysseus Documentation

Welcome to the Odysseus documentation. Odysseus is a fully managed container orchestration platform delivered as a service by Delta Telematics. You sign up, connect your servers, and deploy containers -- we run the control plane, handle upgrades, and keep the orchestration layer available so you can focus on your applications.

There is nothing to install on the control-plane side. The dashboard, scheduling engine, and AI assistant all run on Delta Telematics infrastructure. The only component that runs on your servers is a lightweight agent, installed with a single command.

New to Odysseus? Start with the Quick Start guide to connect your first node and deploy a container in under five minutes.

Documentation Sections

Section Description
Quick Start Sign up, connect a node, and deploy your first container in five steps.
User Guide Complete guide to nodes, deployments, autoscaling, canary releases, secrets, Athena AI, CVE scanning, SRE automation, RBAC, and audit logging.
Architecture How the hosted control plane connects to your nodes, data flow, resilience model, and multi-tenant isolation.
Security Authentication, RBAC, tenant isolation, secrets management, mTLS, audit logging, and compliance posture.
Integrations Connect Odysseus with Prometheus, Grafana, Traefik, CI/CD pipelines, and external monitoring tools.
Troubleshooting Common issues and solutions for node connectivity, deployments, networking, and performance.
Glossary Definitions of platform terms, infrastructure concepts, and security terminology used throughout the documentation.

Key Capabilities

  • Declarative Deployments -- Define your applications in YAML or use the dashboard form, and Odysseus handles scheduling, health monitoring, and automatic recovery across your nodes.
  • Autoscaling -- Scale replicas up and down based on real-time CPU and memory metrics, evaluated every 15 seconds, with configurable min/max boundaries.
  • Canary Releases -- Gradually shift traffic to a new version, monitor error rates and latency in real time, and auto-promote or auto-rollback based on health thresholds.
  • Athena AI Assistant -- A conversational AI built into the dashboard that can query system state, diagnose problems, and execute operations using natural language. 61 tool operations across every platform capability, scoped by your RBAC role.
  • CVE Scanning -- Scan container images for known vulnerabilities before and after deployment. Dual-engine scanning with severity-based deployment policies to block unsafe images.
  • SRE Automation -- Automatic incident detection for crashes, OOM kills, restart loops, and resource exhaustion, with configurable auto-remediation actions and a full incident audit trail.
  • Secrets Management -- Enterprise-grade secret storage with injection via RAM-backed filesystems. Secrets are never written to disk or exposed in environment variables. Automatic rotation with zero-downtime restarts.
  • RBAC and Access Control -- Four built-in roles (Admin, Operator, Developer, Read-only) with JWT authentication and mTLS between components.
  • Audit Logging -- Every action produces a tamper-evident audit record capturing who did what, when, and the outcome. Queryable via the dashboard for compliance reporting.

Using Odysseus

All platform capabilities are accessible through the Dashboard -- the web UI at odysseus.delta-telematics.dev. It provides visual management of nodes, deployments, containers, logs, incidents, CVE scans, and the Athena AI chat panel. No installation required -- just sign in from any modern browser.