@harborclient/team-hub
v0.9.4
Published
Team Hub - central server for HarborClient
Readme

Full documentation: https://harborclient.com/team-hub/
Linux CLI server for shared HarborClient storage, discussions, and team workflows.
team-hub is the central server companion to HarborClient:
- CLI-first: Run and manage the server from the
team-hubcommand. - Fastify HTTP API: Shared collections, environments, and threaded discussions for HarborClient desktop clients.
- Configurable storage: YAML-based server config with MySQL database support.
Documentation
| Topic | Link | | --------------- | ---------------------------------------------------------------- | | Getting started | Introduction | | Prerequisites | Prerequisites | | Setup | Setup | | Development | Development |
Canonical docs live in docs/. Edit those pages directly, then run pnpm docs:build:nav to refresh the VitePress sidebar.
Deployment
Team Hub production deployments use a prebuilt Docker image published to GitHub Container Registry (GHCR). The npm package includes an optional CLI that wraps Docker Compose — Docker remains the runtime.
| Topic | Link | | ---------------- | ----------------------------------------------------------------- | | Deploy overview | Deploy | | Docker Compose | Docker Compose | | npm CLI | npm CLI | | VPS | VPS | | Google Cloud Run | Google Cloud Run | | Kubernetes | Kubernetes |
Standard Docker deployment
# Copy compose.yaml from the npm package or repository (packages/team-hub/deploy/compose.yaml)
curl -fsSLO https://raw.githubusercontent.com/harborclient/harborclient/main/packages/team-hub/deploy/compose.yaml
curl -fsSLO https://raw.githubusercontent.com/harborclient/harborclient/main/packages/team-hub/deploy/.env.example
cp .env.example .env # edit APP_VERSION and TEAM_HUB_DB_PASSWORD
docker compose pull
docker compose up -d --remove-orphansImage: ghcr.io/harborclient/team-hub:<version> (for example 0.8.0 or latest).
Optional CLI deployment
npm install --global @harborclient/team-hub
team-hub deploy install
team-hub deploy status
team-hub deploy logs --tail 200
team-hub deploy updateThe CLI pulls the GHCR image and manages ~/.config/team-hub by default. It does not build the application image locally. Advanced operators can use Docker Compose directly without installing the CLI.
Development
From the monorepo root:
pnpm install
pnpm --filter @harborclient/team-hub test
pnpm --filter @harborclient/team-hub docs:serve
pnpm --filter @harborclient/team-hub docs:buildLicense
MIT
