Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kombify.io/llms.txt

Use this file to discover all available pages before exploring further.

The Tool Launcher provides one-click access to all kombify tools for your connected homelabs. No need to manage separate installations — everything runs in context of your selected stack.

​
Available tools

kombify TechStack

Full orchestration and management

kombify Simulate

Test deployments in simulation

StackKits Studio

Visual StackKit editor

Terminal

SSH access to nodes

​
Launching tools

​
From the dashboard

  1. Select a homelab
  2. Click the Tools dropdown
  3. Choose the tool to launch

​
From homelab details

  1. Open a homelab’s detail view
  2. Use the toolbar icons to launch tools
  3. Tool opens in a new tab with context

​
kombify TechStack

Full-featured orchestration interface for managing your homelab.

​
Features available

  • Node management
  • Service configuration
  • Deployment pipeline
  • Job monitoring
  • Log viewer

​
Launch options

OptionDescription
Read-onlyView configuration without changes
Full accessComplete management capabilities
Specific nodeOpen directly to a node

​
Context passed

When launched, Stack receives:
  • Homelab ID and connection details
  • Your kombify Cloud authentication
  • Role-based permissions

​
kombify Simulate

Test changes in a simulated environment before deploying to production.

​
Features available

  • Create simulation from current config
  • Test StackKit updates
  • Validate configuration changes
  • Network latency testing

​
Workflow

1

Select homelab

Choose which homelab’s config to simulate
2

Launch Sim

Click Launch Sim → opens in new tab
3

Create simulation

Sim auto-creates environment from your config
4

Test changes

Modify and test safely
5

Apply to production

Export validated config back to kombify Cloud

​
Simulation presets

PresetDescription
MirrorExact copy of production config
MinimalReduced resources for quick tests
StressAdd latency/failures for resilience testing

​
StackKits Studio

Visual editor for StackKit configurations.

​
Features available

  • Drag-and-drop service configuration
  • Visual node layout
  • Schema validation in real-time
  • Diff view against current config

​
Capabilities

Add, remove, and configure services visually:
  • Toggle services on/off
  • Set environment variables
  • Configure volumes and networks
  • View generated Docker Compose
Design your node topology:
  • Add/remove nodes
  • Set roles and resources
  • Configure networking
  • View generated Tofu config
Real-time validation feedback:
  • Schema errors highlighted
  • Warnings with suggestions
  • Quick fixes available

​
Export options

FormatDescription
kombination.yamlStandard config file
Docker ComposeGenerated compose file
OpenTofuInfrastructure as code

​
Web terminal

SSH access directly from your browser.

​
Features

  • Full terminal emulation
  • Multiple tabs
  • Copy/paste support
  • Session history

​
Connecting

  1. Select a node
  2. Click Terminal icon
  3. Authenticate (if required)
  4. Terminal opens in-browser

​
Security

  • End-to-end encryption via WebSocket
  • Session timeout after inactivity
  • Audit logging of all commands
  • Role-based access control

​
Tool permissions

Access depends on your team role:
RoleStackSimStudioTerminal
Owner✅ Full✅ Full✅ Full✅ Full
Admin✅ Full✅ Full✅ Full✅ Full
Operator✅ Full✅ Full👁️ View✅ Full
Viewer👁️ View❌👁️ View❌

​
Troubleshooting

Check:
  • Pop-up blocker disabled
  • Agent connected (green status)
  • Sufficient permissions
Try:
  • Refresh the page
  • Reconnect agent
  • Contact team admin
Check:
  • Homelab selected before launch
  • Agent has recent heartbeat
Try:
  • Re-select the homelab
  • Launch from homelab detail page
Check:
  • Node is online
  • SSH service running
  • Firewall allows connection
Try:
  • Verify node health in Stack
  • Check SSH port configuration