Skip to content
Odysseus/docs

Nodes

What This Is For

Section titled “What This Is For”

Nodes is the worker-machine inventory: every enrolled node’s health, schedulability, WireGuard VPN status, CPU/memory capacity and agent version, plus any node that has an enrollment token but has not yet completed enrollment. From here you add a node (generating its bootstrap command), cordon one to stop new placements while letting existing containers keep running, regenerate a stale enrollment token, or push an agent update to one that is out of date.

How You Get Here

Section titled “How You Get Here”

Sidebar section Main → Nodes.

What It Looks Like

Section titled “What It Looks Like”
The Nodes screen in the Odysseus dashboard.

What It Shows

Section titled “What It Shows”

/nodes (Nodes)

Section titled “/nodes (Nodes)”
  • infrastructure:nodes.actions — “Actions”
  • infrastructure:nodes.add-node — “Add Node”
  • infrastructure:nodes.all — “All”
  • infrastructure:nodes.clear-filter — “Clear filter”
  • infrastructure:nodes.containers — “Containers”
  • infrastructure:nodes.cordon — “Cordon”
  • infrastructure:nodes.cordon-node — “Cordon node (prevent new deployments)”
  • infrastructure:nodes.cordoned — “Cordoned”
  • infrastructure:nodes.cpu-cores — “CPU Cores”
  • infrastructure:nodes.created — “Created”
  • infrastructure:nodes.delete — “Delete”
  • infrastructure:nodes.deleting — “Deleting…”
  • infrastructure:nodes.details — “Details”
  • infrastructure:nodes.draining — “Draining”
  • infrastructure:nodes.healthy — “Healthy”
  • infrastructure:nodes.labels — “Labels”
  • infrastructure:nodes.loading-nodes — “Loading nodes…”
  • infrastructure:nodes.memory — “Memory”
  • infrastructure:nodes.name — “Name”
  • infrastructure:nodes.no-matching-nodes — “No matching nodes”
  • infrastructure:nodes.no-nodes — “No nodes”
  • infrastructure:nodes.no-nodes-match-the-selected — “No nodes match the selected filter.”
  • infrastructure:nodes.no-worker-nodes-are-registered — “No worker nodes are registered.”
  • infrastructure:nodes.node — “Node”
  • infrastructure:nodes.nodes — “Nodes”
  • infrastructure:nodes.not-available — “N/A”
  • infrastructure:nodes.not-registered — “Not registered”
  • infrastructure:nodes.pending-enrollments — “Pending Enrollments (”
  • infrastructure:nodes.processing — “Processing…”
  • infrastructure:nodes.refresh — “Refresh”
  • infrastructure:nodes.regenerate-token — “Regenerate Token”
  • infrastructure:nodes.schedulable — “Schedulable”
  • infrastructure:nodes.scheduling — “Scheduling”
  • infrastructure:nodes.status — “Status:”
  • infrastructure:nodes.status-2 — “Status”
  • infrastructure:nodes.these-nodes-have-enrollment-tokens — “These nodes have enrollment tokens but the agent is not yet deployed. Run the bootstrap command on each node to complete enrollment.”
  • infrastructure:nodes.token-status — “Token Status”
  • infrastructure:nodes.total-nodes — “Total Nodes”
  • infrastructure:nodes.uncordon — “Uncordon”
  • infrastructure:nodes.uncordon-node — “Uncordon node (allow new deployments)”
  • infrastructure:nodes.unhealthy — “Unhealthy”
  • infrastructure:nodes.update — “Update”
  • infrastructure:nodes.upgrade-available — “Upgrade available”
  • infrastructure:nodes.vpn-status — “VPN Status”
  • infrastructure:nodes.wireguard-ip — “WireGuard IP”

/nodes/:name (NodeDetail)

Section titled “/nodes/:name (NodeDetail)”
  • infrastructure:nodeDetail.acme-enabled — “ACME enabled”
  • infrastructure:nodeDetail.actions — “Actions”
  • infrastructure:nodeDetail.active-routers — “Active Routers”
  • infrastructure:nodeDetail.active-services — “Active Services”
  • infrastructure:nodeDetail.advertise-address — “Advertise Address”
  • infrastructure:nodeDetail.agent-version — “Agent Version”
  • infrastructure:nodeDetail.all — “All”
  • infrastructure:nodeDetail.all-valid — “All Valid”
  • infrastructure:nodeDetail.also-revoke-wireguard-peer-acl — “Also revoke WireGuard peer, ACL token, and release IP allocation”
  • infrastructure:nodeDetail.approve-agent-upgrade — “Approve Agent Upgrade”
  • infrastructure:nodeDetail.approve-upgrade — “Approve Upgrade”
  • infrastructure:nodeDetail.approved — “(approved”
  • infrastructure:nodeDetail.approving — “Approving…”
  • infrastructure:nodeDetail.approving-this-upgrade-will-schedule — “Approving this upgrade will schedule the agent to download and install the new version. The agent will automatically restart and perform health checks. If the upgrade fails, it will automatically roll back to the previous version.”
  • infrastructure:nodeDetail.back — “Back”
  • infrastructure:nodeDetail.back-to-nodes — “← Back to Nodes”
  • infrastructure:nodeDetail.cancel — “Cancel”
  • infrastructure:nodeDetail.certificate-details — “Certificate Details”
  • infrastructure:nodeDetail.clean-up-enrollment — “Clean up enrollment”
  • infrastructure:nodeDetail.combined-stack-files — “Combined stack files:”
  • infrastructure:nodeDetail.committed — “committed /”
  • infrastructure:nodeDetail.connected — “Connected”
  • infrastructure:nodeDetail.container — “Container”
  • infrastructure:nodeDetail.container-id — “Container ID”
  • infrastructure:nodeDetail.container-s — “container(s)”
  • infrastructure:nodeDetail.container-s-will-be-terminated — “container(s) will be terminated”
  • infrastructure:nodeDetail.continue — “Continue”
  • infrastructure:nodeDetail.copy-to-clipboard — “Copy to clipboard”
  • infrastructure:nodeDetail.cordon — “Cordon”
  • infrastructure:nodeDetail.cordoned — “Cordoned”
  • infrastructure:nodeDetail.cores — “cores (”
  • infrastructure:nodeDetail.current-version — “Current Version”
  • infrastructure:nodeDetail.date — “Date”
  • infrastructure:nodeDetail.days-left — “Days Left”
  • infrastructure:nodeDetail.deployment — “Deployment”
  • infrastructure:nodeDetail.deployment-s — “deployment(s):”
  • infrastructure:nodeDetail.domain — “Domain”
  • infrastructure:nodeDetail.done — “Done”
  • infrastructure:nodeDetail.download-combined — “Download Combined”
  • infrastructure:nodeDetail.download-yaml — “Download YAML”
  • infrastructure:nodeDetail.drain — “Drain”
  • infrastructure:nodeDetail.drain-completed-at — “Drain completed at”
  • infrastructure:nodeDetail.drain-node — “Drain Node”
  • infrastructure:nodeDetail.draining — “Draining”
  • infrastructure:nodeDetail.draining-2 — “Draining…”
  • infrastructure:nodeDetail.draining-this-node-will-evict — “Draining this node will evict all containers and reschedule them to other nodes. The node will be marked as unschedulable during and after the drain operation.”
  • infrastructure:nodeDetail.edge-traefik — “Edge Traefik”
  • infrastructure:nodeDetail.entrypoints — “Entrypoints”
  • infrastructure:nodeDetail.evict-even-if-some-containers — “(Evict even if some containers fail to reschedule)”
  • infrastructure:nodeDetail.eviction-details — “Eviction Details”
  • infrastructure:nodeDetail.expired — “Expired”
  • infrastructure:nodeDetail.expires — “Expires”
  • infrastructure:nodeDetail.expiring — “Expiring”
  • infrastructure:nodeDetail.expiring-soon — “Expiring Soon”
  • infrastructure:nodeDetail.export-all-as-docker-compose — “Export All as Docker Compose”
  • infrastructure:nodeDetail.export-deployments — “Export Deployments”
  • infrastructure:nodeDetail.exported — “Exported”
  • infrastructure:nodeDetail.exporting — “Exporting…”
  • infrastructure:nodeDetail.failed — “Failed”
  • infrastructure:nodeDetail.force-drain — “Force drain”
  • infrastructure:nodeDetail.from — “From”
  • infrastructure:nodeDetail.generate-a-new-enrollment-token — “Generate a new enrollment token for node”
  • infrastructure:nodeDetail.generating — “Generating…”
  • infrastructure:nodeDetail.grace-period-seconds — “Grace Period (seconds)”
  • infrastructure:nodeDetail.healthy — “Healthy”
  • infrastructure:nodeDetail.issuer — “Issuer”
  • infrastructure:nodeDetail.labels — “Labels”
  • infrastructure:nodeDetail.last-checked — “Last checked:”
  • infrastructure:nodeDetail.last-handshake — “Last Handshake”
  • infrastructure:nodeDetail.last-heartbeat — “Last Heartbeat”
  • infrastructure:nodeDetail.latest-version — “Latest Version”
  • infrastructure:nodeDetail.loading-certificate-status — “Loading certificate status…”
  • infrastructure:nodeDetail.loading-node — “Loading node…”
  • infrastructure:nodeDetail.loading-traefik-status — “Loading Traefik status…”
  • infrastructure:nodeDetail.logs — “Logs”
  • infrastructure:nodeDetail.memory — “Memory”
  • infrastructure:nodeDetail.migration-progress — “Migration Progress”
  • infrastructure:nodeDetail.min-days-to-expiry — “Min Days to Expiry”
  • infrastructure:nodeDetail.name — “Name”
  • infrastructure:nodeDetail.network-health — “Network & Health”
  • infrastructure:nodeDetail.never — “Never”
  • infrastructure:nodeDetail.new-enrollment-token-generated-successfully — “New enrollment token generated successfully”
  • infrastructure:nodeDetail.new-version — “New Version”
  • infrastructure:nodeDetail.no-certificate-status-available-for — “No certificate status available for this node”
  • infrastructure:nodeDetail.no-containers-running-on-this — “No containers running on this node.”
  • infrastructure:nodeDetail.no-traefik-status-available-for — “No Traefik status available for this node”
  • infrastructure:nodeDetail.node — “Node:”
  • infrastructure:nodeDetail.node-id — “Node ID”
  • infrastructure:nodeDetail.node-not-found — “Node not found.”
  • infrastructure:nodeDetail.node-record-will-be-deleted — “Node record will be deleted from cluster”
  • infrastructure:nodeDetail.not-assigned — “Not assigned”
  • infrastructure:nodeDetail.not-registered — “Not registered”
  • infrastructure:nodeDetail.not-running — “Not Running”
  • infrastructure:nodeDetail.pending-upgrade — “Pending Upgrade”
  • infrastructure:nodeDetail.processing — “Processing…”
  • infrastructure:nodeDetail.public-key — “Public Key”
  • infrastructure:nodeDetail.ready — “Ready”
  • infrastructure:nodeDetail.regenerate-enrollment-token — “Regenerate Enrollment Token”
  • infrastructure:nodeDetail.regenerate-token — “Regenerate Token”
  • infrastructure:nodeDetail.release-notes — “Release Notes”
  • infrastructure:nodeDetail.remove-node — “Remove Node”
  • infrastructure:nodeDetail.remove-node-2 — “Remove Node:”
  • infrastructure:nodeDetail.removing — “Removing…”
  • infrastructure:nodeDetail.reschedule-containers-to-other-nodes — “Reschedule containers to other nodes”
  • infrastructure:nodeDetail.rescheduled — “Rescheduled”
  • infrastructure:nodeDetail.resource-usage — “Resource Usage”
  • infrastructure:nodeDetail.run-this-command-on-the — “Run this command on the target node:”
  • infrastructure:nodeDetail.running-containers — “Running Containers”
  • infrastructure:nodeDetail.schedulable — “Schedulable”
  • infrastructure:nodeDetail.scheduling — “Scheduling”
  • infrastructure:nodeDetail.services — “services)”
  • infrastructure:nodeDetail.skip-export — “Skip Export”
  • infrastructure:nodeDetail.ssl-certificates — “SSL Certificates”
  • infrastructure:nodeDetail.stack — “(stack:”
  • infrastructure:nodeDetail.stack-2 — “Stack:”
  • infrastructure:nodeDetail.started — “Started:”
  • infrastructure:nodeDetail.status — “Status”
  • infrastructure:nodeDetail.stopped — “Stopped”
  • infrastructure:nodeDetail.target-node — “Target Node”
  • infrastructure:nodeDetail.terminate-all-containers — “Terminate all containers”
  • infrastructure:nodeDetail.terminated — “Terminated”
  • infrastructure:nodeDetail.the-following-will-happen — “The following will happen:”
  • infrastructure:nodeDetail.this-action-cannot-be-undone — “This action cannot be undone.”
  • infrastructure:nodeDetail.this-is-useful-if-the — “. This is useful if the original token has expired or was lost.”
  • infrastructure:nodeDetail.this-will-invalidate-any-previous — “This will invalidate any previous enrollment tokens for this node.”
  • infrastructure:nodeDetail.time-to-wait-for-containers — “Time to wait for containers to gracefully terminate (0-300 seconds)”
  • infrastructure:nodeDetail.to — “To”
  • infrastructure:nodeDetail.total-certs — “Total Certs”
  • infrastructure:nodeDetail.total-containers — “Total Containers”
  • infrastructure:nodeDetail.uncordon — “Uncordon”
  • infrastructure:nodeDetail.unhealthy — “Unhealthy”
  • infrastructure:nodeDetail.unknown-version — “Unknown”
  • infrastructure:nodeDetail.update-available-v — “Update available: v”
  • infrastructure:nodeDetail.upgrade — “Upgrade”
  • infrastructure:nodeDetail.upgrade-history — “Upgrade History”
  • infrastructure:nodeDetail.upgrade-via-deployment-scaling — “Upgrade via deployment scaling”
  • infrastructure:nodeDetail.valid — “Valid”
  • infrastructure:nodeDetail.version — “Version”
  • infrastructure:nodeDetail.view — “View”
  • infrastructure:nodeDetail.vpn-ip-address — “VPN IP Address”
  • infrastructure:nodeDetail.warnings — “Warnings:”
  • infrastructure:nodeDetail.will-be-evicted-from-this — “will be evicted from this node.”
  • infrastructure:nodeDetail.wireguard-peer-acl-token-and — “WireGuard peer, ACL token, and IP allocation will be revoked”
  • infrastructure:nodeDetail.wireguard-vpn — “WireGuard VPN”

What You Can Do

Section titled “What You Can Do”

/nodes

Section titled “/nodes”

This screen’s component declares no permission-gated controls.

/nodes/:name

Section titled “/nodes/:name”

This screen’s component declares no permission-gated controls.

Where To Go Next

Section titled “Where To Go Next”

Walk the actual bootstrap flow in enrol a node. If a node you enrolled never appears, or appears and stays unhealthy, work through a node you enrolled is not listed. For how a node’s labels and capacity feed into where deployments land, see placement and allocation.