labtether README

The project's README from github.com/labtether/labtether. As one markdown file: README.md.

LabTether

LabTether

Cross-platform homelab control plane with AI-powered operations.

CI Go Docker License Discord Demo

Website · Docs · Wiki · Discord · Demo · Changelog · Security · Closed CVEs

LabTether Dashboard

LabTether Walkthrough
Dashboard → Devices → Topology → Terminal → Alerts → Files

AI-Native
Built-in MCP server with 23+ tools. Operate your fleet through Claude, OpenClaw, Cursor, or any AI agent.
Cross-Platform
Linux and macOS are supported, Windows support is partial, and FreeBSD is planned — all tracked from one hub.
Secure by Default
Tailscale integration, 2FA, OIDC/SSO, RBAC, audit logs, and TLS — out of the box.

Why LabTether

You run Proxmox, TrueNAS, Docker, maybe Home Assistant. Each has its own dashboard, its own alerts, its own way of telling you something is wrong. When a drive starts failing at 2 AM, you're opening five tabs trying to piece together what happened.

LabTether replaces the tab sprawl with one dashboard, one timeline, one URL.


Quick Start

Get a full LabTether hub running in under 5 minutes. You need Docker and Docker Compose 2.33.1 or newer. Download and inspect the release installer, then pin the release you intend to run:

curl --proto '=https' --tlsv1.2 -fsSLo install-labtether.sh https://labtether.com/install.sh
less install-labtether.sh
LABTETHER_VERSION=vX.Y.Z bash install-labtether.sh

The installer verifies coordinated release checksums, verifies signed GitHub provenance when gh is available, and deploys digest-pinned images. Open http://localhost:3000 when it finishes; the setup wizard walks you through the rest. TLS certificates are generated automatically.

Full guide with Tailscale remote access, custom TLS, OIDC SSO, and multi-user setup at labtether.com/docs.

Advanced: Docker Compose

The verified installer writes the release-specific Compose file, environment template, manifest, and checksums into its install directory. Customize those pinned artifacts for split services, external Postgres, or resource limits; do not deploy the mutable main branch or latest image tag directly.


Install Agents

Agents are optional -- connectors like Proxmox and TrueNAS work without them. Agents unlock deeper telemetry, remote terminal and desktop access, and action execution on your nodes.

Linux

Choose an exact release, verify its checksum and GitHub build attestation, then enroll:

VERSION=vX.Y.Z
ASSET=labtether-agent-linux-amd64
tmp_dir="$(mktemp -d)"
curl --proto '=https' --tlsv1.2 -fL \
  "https://github.com/labtether/labtether-agent/releases/download/${VERSION}/${ASSET}" \
  -o "${tmp_dir}/${ASSET}"
curl --proto '=https' --tlsv1.2 -fL \
  "https://github.com/labtether/labtether-agent/releases/download/${VERSION}/${ASSET}.sha256" \
  -o "${tmp_dir}/${ASSET}.sha256"
(cd "$tmp_dir" && sha256sum --check "${ASSET}.sha256")
gh attestation verify "${tmp_dir}/${ASSET}" -R labtether/labtether-agent
sudo install -m 0755 "${tmp_dir}/${ASSET}" /usr/local/bin/labtether-agent
rm -rf "$tmp_dir"
umask 077
token_file="$(mktemp)"
trap 'rm -f "$token_file"' EXIT
read -r -s -p 'Enrollment token: ' enrollment_token
printf '\n'
printf '%s\n' "$enrollment_token" > "$token_file"
unset enrollment_token
sudo env \
  LABTETHER_WS_URL=wss://your-hub:8443/ws/agent \
  LABTETHER_ENROLLMENT_TOKEN_FILE="$token_file" \
  /usr/local/bin/labtether-agent

Or use the hub's generated install command -- it handles the download automatically.

See the Linux agent setup guide for systemd installation and enrollment.

macOS

Download LabTether Agent.app from Releases. Drag to Applications and launch -- the menu bar icon handles enrollment.

Windows

The cross-platform endpoint agent publishes Windows amd64 and arm64 binaries. Use the hub-generated PowerShell onboarding command; the separate native system-tray application remains planned.

FreeBSD

FreeBSD endpoint management is planned. The source currently cross-compiles in CI, but there is no published FreeBSD agent artifact or agentless connector contract yet. A FreeBSD host can still be represented as a manual inventory device and reached through a separately configured generic protocol such as SSH.

Agent docs: labtether.com/docs/install-upgrade/agent-install-commands-by-os


What You Get

AI-Powered Operations

MCP Claude OpenClaw

LabTether ships a built-in MCP server with 23+ tools. Connect Claude, OpenClaw, Cursor, or any MCP-compatible AI agent and operate your infrastructure through natural language:

"Restart the nginx container on prod-web-01" -- your AI agent does it through LabTether's MCP endpoint.

Secure Remote Access with Tailscale

One-click Tailscale Serve integration. Expose your hub over HTTPS to your tailnet -- no port forwarding, no dynamic DNS, no certificates to manage. Managed mode handles everything automatically.

Fleet Dashboard

Health at a glance. CPU, memory, disk, network, and temperature across every node.

Fleet Dashboard

Remote Terminal and SSH

Browser-based shell sessions with snippets, bookmarks, and persistent sessions. Manage SSH connections, keys, and protocols per device. Quick-connect from the command palette -- no SSH keys needed.

Remote Terminal

Remote Desktop

VNC and SPICE desktop access directly from the browser. Session recordings for audit and compliance.

File Manager

Browse, upload, download, and transfer files between devices from one interface.

File Manager

Alerts, Incidents, and Logs

Define alert rules, route notifications, silence during maintenance, and triage from one correlated timeline. Full incident tracking with postmortem analysis. Centralized log viewer with search, filtering, and journal access across all nodes.

Alerts

Containers and Services

Monitor and manage Docker containers and Compose stacks across your fleet. Discover, group, and monitor web services with health checks and custom icons.

Topology Map

Visualize your infrastructure, dependencies, and network relationships. Blast radius analysis for change planning.

Topology Map

Automation

Save and execute actions across devices. Webhooks and scheduled jobs for hands-free operations. Cron-like scheduling with group-aware execution.

Integrations

Connect what you already run: Proxmox VE, TrueNAS, Docker, Portainer, Home Assistant, and Proxmox Backup Server. Auto-discovery finds your infrastructure automatically.

Enterprise Security

2FA, OIDC/SSO, RBAC, API keys, TLS management, Prometheus metrics export, data retention policies, and a full audit log. Everything you need for compliance.

And More

Groups and Maintenance -- Organize assets with maintenance windows and reliability tracking. Update Runs -- Plan and execute updates with dry-run support and audit trails. Command Palette -- Cmd+K to jump anywhere, quick-connect to devices, or run saved actions. API Docs -- Built-in OpenAPI reference for every endpoint.

All Screenshots

Fleet Dashboard
Fleet Dashboard — all nodes at a glance

Device Detail
Device Detail — deep telemetry per host

Remote Terminal
Remote Terminal — browser-based shell with snippets and bookmarks

File Manager
File Manager — browse, upload, download, and transfer files

Services
Services — discover and monitor web services with health checks

Topology Map
Topology Map — visualize your infrastructure and dependencies

Alerts and Incidents
Alerts — correlated timeline with routing and silencing

Logs
Logs — centralized viewer with search and filtering

Health Overview
Health — reliability tracking and system health checks

Settings
Settings — integrations, security, agents, and notifications

Login
Login — 2FA, OIDC/SSO, and secure authentication


Supported Integrations

Proxmox VE Proxmox Backup Server TrueNAS Docker Portainer Home Assistant Tailscale MCP


Ecosystem

Platform Description
Linux Agent Linux Telemetry, remote access, and actions for Linux machines.
CLI Cross-platform Manage your hub from the terminal.

Coming soon

Platform Description
Windows Agent Windows 10+ Native system tray app with service management and auto-updates.
macOS Agent macOS 13+ Menu bar app with status, enrollment, and notifications.
FreeBSD Agent FreeBSD 13+ Planned; source/runtime hooks exist, but no public release artifact is published.
iOS & iPad Companion iPhone / iPad Mobile fleet monitoring, push notifications, and live activities. One-time purchase, no subscriptions.

Community


Documentation


Copyright 2026 LabTether. Apache 2.0

labtether (labtether/labtether)

Searching Database…

这是什么?LabTether 是一个自托管控制平面,把家庭实验室(Proxmox、TrueNAS、Docker、Home Assistant 等)的监控与控制统一到一个仪表盘中,提供远程终端、远程桌面、告警,以及一个可供 AI 操作的接口。
它是仪表盘应用,还是更像要装到每台机器上的监控代理?两者都是:一个通过 Docker Compose 运行的中央自托管枢纽(仪表盘、API、Postgres),外加可选的轻量端点代理,安装在每台机器上以获取更深入的遥测数据和远程访问能力。
怎么让枢纽跑起来?下载并校验发行版安装程序,固定一个发行版本,用 Docker 和 Docker Compose 2.33.1+ 运行它;安装程序会部署按摘要固定的镜像,设置向导完成配置,TLS 证书自动生成。
运行它需要 Docker 和 Postgres 吗?需要,枢纽以 Docker Compose 服务的形式运行,由 Postgres 支撑;代理是可选的附加组件,用于你想要深度访问的每台设备。
Windows 和 FreeBSD 支持真的就绪了吗?Windows 代理支持是部分的(仅支持 PowerShell 接入,还没有原生托盘应用),FreeBSD 则完全没有发布代理工件,不过 FreeBSD 主机可以手动作为基于 SSH 的设备添加。
目前哪些操作系统能运行代理?Linux 和 macOS 代理目前已完全支持(macOS 通过一个拖入 Applications 的菜单栏应用);Windows 代理二进制文件已存在但功能不全,FreeBSD 和 iOS/iPad 伴侣应用在计划之中。
我的基础设施数据会留在自己的网络里吗?会,由于它通过 Docker Compose 加 Postgres 完全自托管,你的数据永远不会离开你的网络。
MCP 服务器如何让 AI 代理控制我的家庭实验室?LabTether 内置一个带 23+ 工具的 MCP 服务器,Claude、OpenClaw、Cursor 等助手可以通过自然语言执行命令、重启服务、读取日志、管理 Docker 堆栈、检查连接器健康状况并触发 webhook。
不开端口的情况下,远程访问我的设备是怎么实现的?LabTether 提供一键式 Tailscale Serve 集成,通过 HTTPS 把枢纽暴露给你的 tailnet,另外还有基于浏览器的 SSH 终端和带录制功能(用于审计)的 VNC/SPICE 远程桌面会话。
开箱即用能连接哪些集成?它会自动发现并连接 Proxmox VE、TrueNAS、Docker、Portainer、Home Assistant 和 Proxmox Backup Server。
内置了哪些安全功能?默认包含 2FA、OIDC/SSO、RBAC、API 密钥、TLS 管理、Prometheus 指标导出、数据保留策略和完整的审计日志。
What are similar projects?Termix, xpipe, NodePilot, turnstone, casdoor, zitadel, stalwart, dockhand
Creator
labtether
Size
50.3 MB
Stars
249
Age
6mo
Commits · 90 Days