Documentation

Connect your first node

Bootstrap a Linux host into StackShift and verify it is healthy enough to host workloads.

Getting Started

Connect your first node

Live

Bootstrap a Linux host into StackShift and verify it is healthy enough to host workloads.

Goal

Attach your first node and get it to a schedulable state.

Current status

Live

This area is documented as current, user-reliable behavior.

Workflow

  1. 1Open the Nodes page and generate the install command.
  2. 2Run the command on the target machine to install and start the agent.
  3. 3Wait for the node heartbeat and readiness checks to populate in the dashboard.
  4. 4Review health, agent version, runtime readiness, and any maintenance state before using the node.

Expected result

The node appears healthy and can accept placements.

Common failures

  • Install token expired or invalid
  • Agent service not running on the node
  • Node appears but stays agent unknown or disconnected