Harbory icon

Harbory

Harbory is an open source Rust-based orchestration system for managing containers, reverse proxies, and remote VMs from a dashboard for small server fleets.

Harbory

Infrastructure orchestration for small VM fleets

Harbory is an open source infrastructure orchestration system written in Rust. It uses a central control plane and lightweight agents to manage containers, reverse proxies, and remote VMs from a web dashboard or JSON API.

The product is positioned for small fleets of servers rather than large datacenters. Its setup flow focuses on pairing a host with a short-lived token, then letting the agent reconcile Docker containers and Nginx configuration without requiring a Kubernetes cluster, YAML manifests, or cluster bootstrap steps.

Core capabilities

Container deployment and reconciliation

Define desired container state from the dashboard or API, and the agent reconciles that state against Docker automatically. The docs say containers can be deployed, redeployed, or removed as the agent converges on each heartbeat.

Reverse proxy management

Create reverse proxy routes that are templated and validated before reload. The source says Nginx only reloads if the generated config passes validation, which prevents a bad configuration from reaching live traffic.

Agent pairing and authentication

Use short-lived pairing tokens and signed credentials so agents prove key possession on each connection. The source also describes challenge/response authentication rather than relying only on a bearer token.

Web dashboard

Pair agents, deploy containers and routes, and monitor a live security and activity feed from the web dashboard. The interface is positioned as the main control surface for day-to-day management.

Distributed control plane architecture

Run a single control plane process that coordinates multiple lightweight agents over a persistent gRPC stream. The site contrasts this with operating a full Kubernetes cluster and its related control-plane components.

Practical ways to use Harbory

  • Manage containers across a small server fleet

    Use Harbory when you want to run and update containerized services on a few Linux hosts without managing Kubernetes components or writing layered YAML definitions.

  • Control reverse proxy routing

    Use the product to publish services behind Nginx, especially when you want proxy routes templated and validated before reload rather than edited manually on each host.

  • Pair a new host to the control plane

    Install the agent on a fresh VM, generate a pairing token from the dashboard, and connect the host to the control plane with a second command.

  • Run a self-hosted control plane

    For teams that want to self-host orchestration, the docs describe a control plane installer that can be configured with your own database and Supabase settings.

  • Deploy containers from a repository

    If you want to deploy from GitHub instead of from a registry image, Harbory can clone and build a repo on the target host when GitHub OAuth is configured.

Pros and Cons

Pros

  • No Kubernetes control plane is required; Harbory uses a single control plane and lightweight agents.
  • The agent installation and pairing flow is documented with apt-based and source-build paths.
  • Container state is reconciled automatically against Docker, which reduces manual redeploy work.
  • Nginx routes are validated before reload, lowering the chance of pushing a broken proxy configuration.
  • The web dashboard centralizes pairing, deployment, and activity monitoring.

Cons

  • The source is stronger on host installation and agent pairing than on broader integrations or advanced ecosystem support.
  • Running your own control plane requires additional setup for database and Supabase configuration, and public exposure needs a separate reverse proxy with TLS.
  • GitHub repository deploys are optional and require GitHub OAuth App configuration before they work.

FAQ

What is Harbory for?

The source describes Harbory as a distributed control plane and agent system for managing containers, reverse proxies, and remote VMs from one dashboard. It is intended for users who want infrastructure orchestration without operating a Kubernetes cluster.

How do you install and connect an agent?

The docs say a host can be installed with an apt-based path on Ubuntu/Debian or by building from source. After installation, you generate a short-lived pairing token in the dashboard and run the pairing command on the host.

What can the platform manage?

Harbory can manage container state, configure Nginx reverse proxy routes, and coordinate agents over a persistent authenticated connection. The docs also mention deploying containers from a GitHub repository if the control plane is configured with GitHub OAuth.

Does Harbory provide a web UI and API?

The product exposes a web dashboard for pairing agents, deploying containers and routes, and viewing activity and security information. The docs also mention a plain JSON API for desired state.

Can I run my own control plane?

The source indicates the control plane can be self-hosted, with its installer writing placeholders for database and Supabase configuration. The control plane only binds to 127.0.0.1, so the docs say it needs a separate reverse proxy with a TLS certificate if exposed publicly.

Quick Facts

Category
Developer Tool
Platform
Web dashboard plus Linux agent
Primary users
People managing a small fleet of VMs
Technology
Rust, Docker, Nginx, gRPC
Deployment model
Open source, self-hostable control plane with paired agents
Source domain
harbory.preetindersingh.tech