Skip to content
Odysseus

Deploy your first container

Goal

A container of your own running on a node you enrolled, visible in the dashboard.

Before you start

  • A tenant account and a dashboard sign-in.
  • One Linux machine you can open a root shell on, with Docker installed.
  • Outbound HTTPS from that machine to the control plane.

Steps

  1. Sign in to the dashboard and open Nodes. It is empty.
  2. Choose Enrol a node. The dashboard shows an install command carrying a single-use token.
  3. Run that command as root on your machine. It ends by reporting that the agent is enrolled.
  4. Return to Nodes. Your machine appears and becomes ready within about half a minute.
  5. Open Deployments, choose New deployment, name it hello, and set the image to nginx:1.27-alpine.
  6. Choose Deploy. The deployment moves from pending to running.
  7. Open the deployment and choose Logs. nginx’s start-up lines appear.

Verify

The deployment reports one running replica, and the container is listed under the node from step 4.

Budget about 15 minutes. Most of it is waiting for the agent’s first check-in.