Skip to content
LabTether

LabTether Documentation

LabTether is a self-hosted hub for your homelab. You run it in Docker, and it manages Linux and macOS nodes, plus Windows nodes with partial support. From the hub you can open a terminal or remote desktop on your machines, watch their metrics, get alerts, and see which services run where.

Key concepts

  • Hub: the central server that runs the API, background jobs and connectors. You deploy it once with Docker Compose.
  • Console: the web interface you open in a browser to manage your lab.
  • Node: any managed system in your inventory, such as a VM, a bare-metal machine or a container host. The console lists them on the Devices page.
  • Agent: a program you install on a node for metrics, logs, terminal, remote desktop and file access.
  • Connector: a link to a platform you already run (Proxmox VE, Proxmox Backup Server, TrueNAS, Portainer, Home Assistant). It reads that platform's API, so its VMs, pools and containers appear without an agent on every device. Docker is read through the agent on each Docker host.
  • Session: a live interactive connection to a node, either a terminal shell or a remote desktop.

What you'll need

  • Docker Engine with the Compose plugin, version 2.33.1 or newer, on the machine that will host the hub.
  • A machine to manage: start with a Linux or macOS node, or a Windows node with partial support. See Platform Support before choosing another platform.
  • A browser that can reach the hub, such as Chrome, Firefox, Safari or Edge.

You do not need Kubernetes, an external database or DNS records to get started.

The live demo is a read-only console you can open without signing up.

Get started

The Quickstart covers install, setup and your first device on one page.

For more detail, follow Installation, First Login and Your First Node and Connector in order.

Finding your way