Quick Start

Go from zero to a running container in five steps. Odysseus is a fully managed platform -- the control plane is hosted for you. All you need is a Linux server with Docker installed.

Step 1: Sign Up

Create your account at odysseus.delta-telematics.dev. The guided onboarding wizard walks you through initial setup:

1. Enter your email and create a password (or sign in with SSO).
2. Name your organization and invite team members (optional -- you can do this later).
3. Choose your deployment path:
   • Single server -- One node for development, staging, or small workloads.
   • Multi-node cluster -- Multiple servers for production workloads with scheduling across nodes.
   • Edge -- Lightweight nodes at edge locations connected back to the control plane.

After completing the wizard, you land on the dashboard with your unique install command ready to copy.

Step 2: Connect Your First Node

Run the one-liner install script shown in your dashboard on any Linux server. The script is unique to your account and contains an enrollment token.

Prerequisites

• Operating system: Ubuntu 20.04+, Debian 11+, or RHEL/CentOS 8+
• Docker: Docker Engine 20.10 or later installed and running
• Network: Outbound HTTPS (port 443) to odysseus.delta-telematics.dev
• Network: Outbound UDP port 51820 for WireGuard VPN tunnel
• Permissions: Root or sudo access (for the initial install only)

Network & Firewall Requirements

After enrollment, the agent communicates with the control plane over an encrypted WireGuard VPN tunnel. The following ports must be open on the WireGuard interface (wg0) for the node to function correctly:

sudo iptables -I INPUT -i wg0 -p tcp --dport 8081 -j ACCEPT
sudo iptables -I INPUT -i wg0 -p tcp --dport 9501 -j ACCEPT
sudo iptables -I INPUT -i wg0 -p tcp --dport 8300 -j ACCEPT
sudo iptables -I INPUT -i wg0 -p tcp --dport 8301 -j ACCEPT
sudo iptables -I INPUT -i wg0 -p udp --dport 8301 -j ACCEPT

Install the Agent

Copy the command from the dashboard and run it on your server:

curl -fsSL https://odysseus.delta-telematics.dev/install | sudo bash -s -- --token YOUR_ENROLLMENT_TOKEN

The install script performs three actions:

1. Installs the Odysseus agent -- a lightweight binary that manages containers on this node.
2. Establishes an encrypted WireGuard VPN tunnel to the control plane for secure communication.
3. Registers the node with your account and reports its capacity (CPU, memory, disk).

Step 3: Deploy Your First Container

Deploy your first container using the dashboard.

Dashboard

Click New Deployment in the dashboard. Fill in the form:

• Name: hello-web
• Image: nginx:alpine
• Replicas: 2
• Port: 80

Click Deploy. Odysseus validates the configuration, schedules containers across your nodes, pulls the image, and starts the containers.

Step 4: Scale and Monitor

Your deployment is running. Now scale it and observe the metrics.

Manual Scaling

Scale from the dashboard by editing the deployment and adjusting the replica count.

Autoscaling

Enable autoscaling from the deployment settings to let Odysseus manage replica counts automatically based on CPU utilization. Set a target CPU percentage and min/max replica bounds.

Prometheus metrics drive scaling decisions. The autoscaler evaluates metrics every 15 seconds and adjusts replicas to keep CPU utilization near your target.

Monitoring

The dashboard displays real-time metrics for every deployment:

• CPU and memory usage per container
• Request rates and error rates
• Container health status and restart counts
• Autoscaler decisions and scaling history

Step 5: Explore Advanced Features

You have a running, scalable deployment. Here is what to explore next:

Next Steps

• Read the User Guide for in-depth coverage of every feature.
• Review Security to understand the platform's security model.
• Check Integrations to connect Odysseus with your CI/CD pipeline and monitoring stack.