Start Here
Read the platform like it actually works, not like a marketing funnel.
Start with the introduction if you need the product model. Jump into projects, stacks, templates, nodes, databases, operations, domains, billing, team, AI, or settings if you already know the area you need.
Introduction
Open sectionStart with the product model, terminology, and how the control plane actually works today.
What is StackShift
LiveA precise description of StackShift as it exists today: a self-hosted application platform control plane for deploying and operating workloads across connected nodes.
Core concepts
LiveA glossary and mental model for projects, stacks, templates, nodes, databases, deployments, and operations.
How StackShift works
LiveA product-level walkthrough of how the control plane, worker, agent, and runtime hosts cooperate.
Current platform status and terminology
LiveA maturity guide for reading the platform docs without collapsing every user-visible surface into the same confidence level.
Getting Started
Open sectionGet from account setup to first workload without learning the entire platform first.
Create your account
LiveCreate an account, verify access, and understand the first-run requirements before deploying anything.
Connect GitHub
LiveLink GitHub so project-style deployments can pull repositories and deployment metadata cleanly.
Connect your first node
LiveBootstrap a Linux host into StackShift and verify it is healthy enough to host workloads.
Deploy your first workload
LiveChoose the right first deployment path based on whether you are deploying an app, a Compose service, or a curated template.
Projects
Open sectionUse projects for application-centric deployments from GitHub or Docker images.
Deploy a Docker image
LiveRun a raw container image through the project flow when you already have an image and need runtime configuration, resource sizing, storage, domains, and placement.
Deploy from GitHub
LiveUse the repository-backed project flow when you want StackShift to detect the app, build from source, and let you override runtime behavior before the first deploy.
Builds, deployments, and logs
LiveUnderstand the project execution lifecycle: build output, deploy state, rollback behavior, and where to inspect logs.
Project environment, domains, and previews
LiveConfigure the project surfaces that most often decide whether a deployment works after it builds, including runtime shape, domains, previews, and storage.
Stacks
Open sectionUse stacks for Compose workloads, service-style systems, and stateful multi-container apps.
What stacks are
LiveStacks are the service-oriented workload model in StackShift, built around Compose, named volumes, and node-aware placement.
Deploy a Compose stack
LiveBring a Compose-defined workload to StackShift with domains, placement, and persistent volumes.
Stack logs, health, and placement
LiveUse the stack detail, logs, and placement information to understand how the stack is actually running.
Back up and restore a stack
LiveUse S3-backed named-volume archives to protect and recover stateful stack data.
Templates
Open sectionTemplates are curated stack blueprints with versioning, service notes, and safer lifecycle controls.
What templates are
LiveTemplates are versioned service blueprints that render into stacks with saved inputs and provenance.
Deploy from a template
LiveLaunch a curated service by supplying template inputs, choosing placement, and reviewing the rendered summary.
Deploy WordPress on StackShift
LiveLaunch single-site WordPress as a template-backed stack with bundled MariaDB and persistent storage.
Deploy WordPress for agencies
LiveUse the WordPress + Elementor template when you want visual editing and builder-friendly PHP defaults available immediately after launch.
Nodes
Open sectionNodes are the runtime hosts attached to StackShift through the agent.
Node overview
LiveWhat a node is, what the agent does, and what node health means in StackShift.
BYOCloud overview
LiveUse customer-owned cloud accounts as StackShift node hosts without turning the product into a generic cloud console.
Connect a BYOCloud node
LiveSave provider credentials, choose a tested region and StackShift tier, and wait for the provisioned cloud node to become healthy and schedulable.
BYOCloud resource add-ons
Live with caveatsManage provider-backed node resources such as volumes, snapshots, placement metadata, and stable public IP actions from the node-scoped cloud resources surface.
Databases
Open sectionManaged databases are first-class resources with their own lifecycle, credentials, and recovery behavior.
Managed database overview
LiveHow StackShift databases fit into the platform and how they differ from stack-hosted stateful services.
Create a database
LiveProvision a managed database and understand the minimum runtime and recovery expectations around it.
Credentials, pooling, and usage expectations
LiveUnderstand how to consume database connection details and what to assume about pooling and access patterns.
Back up and restore a database
LiveUse the current S3-backed database backup and restore model with the correct operational expectations.
Operations
Open sectionUse the operations surfaces to understand health, services, alerts, node state, and recovery progress.
Operations overview
LiveThe operations area is the cross-resource health and runtime visibility surface for StackShift.
Services view
LiveTrack stack-backed services and databases in one place with health, backup posture, and upgrade cues.
Alerts view
LiveUse alerts to focus on active operational problems instead of scanning every resource manually.
Nodes view
LiveUse the node-focused operations surface when you need to think about capacity, health, and runtime readiness across hosts.
Domains & Email
Open sectionUse StackShift’s domain and email product surfaces with the right maturity expectations.
Domain search, purchase, and portfolio
LiveFind and acquire domains, then understand how they appear in the domain portfolio.
DNS records and project connection
LiveManage DNS records and connect domains to projects or other runtime surfaces.
Transfers, email hosting, orders, and settings
LiveUse the broader domain-management surfaces for transfers, email hosting, orders, and settings from the main domains product area.
Team & Access
Open sectionInvite collaborators, manage members, and work with the current team collaboration model.
Teams overview
LiveThe teams area lets you create teams, view team membership, and manage team-level collaboration flows.
Invitations
LiveAccepting and managing invitations is a user-visible part of the collaboration model.
Roles and collaboration expectations
LiveUnderstand owner, admin, and member style collaboration capabilities in the current team model.
Billing
Open sectionBilling covers plans, subscription state, usage, transactions, payment methods, and spending controls.
AI Features
Open sectionAI features currently center on diagnosis and guided investigation, with clear operator-first expectations.
Settings
Open sectionAccount, global environment, and notification settings are part of day-to-day platform administration.
Profile and account settings
LiveUse account-level settings for user profile and basic account administration.
Security and connections
LiveManage password changes, active sessions, GitHub app installs, and other connected-account behavior from the settings area.
Global environment variables
LiveUnderstand the global env surface and how it differs from project- or stack-specific runtime configuration.
Notifications
LiveUse the notifications surfaces to stay aware of platform activity and alerts.