Section Overview
Nodes
Nodes are the runtime hosts attached to StackShift through the agent.
Node overview
What a node is, what the agent does, and what node health means in StackShift.
Goal
Understand nodes as runtime machines with operational state, not just a list in the UI.
Expected result
You understand how StackShift reasons about node readiness and workload placement.
BYOCloud overview
Use customer-owned cloud accounts as StackShift node hosts without turning the product into a generic cloud console.
Goal
Understand what BYOCloud includes today, which providers are supported, and how the product boundary stays node-led.
Expected result
You understand BYOCloud as a StackShift node workflow instead of a raw provider-management feature.
Connect a BYOCloud node
Save provider credentials, choose a tested region and StackShift tier, and wait for the provisioned cloud node to become healthy and schedulable.
Goal
Walk from saved provider credentials to a healthy BYOCloud node in the Nodes page.
Expected result
A BYOCloud node is provisioned and ready to host projects, stacks, or database flows once healthy.
BYOCloud resource add-ons
Manage provider-backed node resources such as volumes, snapshots, placement metadata, and stable public IP actions from the node-scoped cloud resources surface.
Goal
Explain the Phase 3 BYOCloud add-ons that deepen node operations without turning StackShift into a cloud console.
Expected result
Operators can handle the common cloud-backed node relationships StackShift supports without dropping into the provider console for every action.
Install the agent
Bootstrap a new node and understand what the install command is doing on the target host.
Goal
Install the agent cleanly and know how to verify success on the host itself.
Expected result
The node is attached and the agent is running.
Upgrade the agent
Use the maintenance-first path to move an existing node to a newer agent version.
Goal
Update the node agent without leaving it in a confused scheduling state.
Expected result
The node reports the expected agent version and can safely leave maintenance.
Maintenance mode
Use maintenance as a safety control before upgrades or disruptive host changes.
Goal
Keep nodes out of the scheduler when you are about to perform risky host-level work.
Expected result
Node lifecycle work happens with fewer accidental scheduling side effects.
Node health, diagnostics, and deletion
Read node diagnostics correctly and understand when deletion is safe or blocked.
Goal
Avoid deleting or trusting a node without checking the operational details that matter.
Expected result
Node cleanup and diagnostics become deliberate, not reactive.