Introduction

Huell is a self-hostable docs platform: connect a GitHub repo (or upload a docs.zip), and Huell builds and publishes a clean, searchable docs site for it — on your own server, under your own domain.

Huell is one deployable instance per organization. There’s no shared multi-tenant service — you run it, you own the data, you own the infrastructure.

Why

Popular hosted docs platforms are great for authoring, but self-hosting at their enterprise tier often means a Kubernetes-scale deployment — separate databases for metadata, sessions, and object storage, sized for companies running dozens of large public docs sites.

Note

Huell targets a much smaller, more common case: a small team with docs content (MDX + a nav config) who wants it built and served without a vendor contract or that much infrastructure.

The whole stack — dashboard, build worker, and every project’s docs site — is designed to run comfortably on a single small VM.

How it fits together

Piece	What it is
Dashboard	Sign in, manage projects and members, connect GitHub or upload docs
Build worker	Picks up queued builds, converts your docs into a site, deploys it
Docs sites	One per project, its own subdomain, built with Astro Starlight

See Architecture for how a request actually gets routed to each of these, and how TLS certificates get issued per project.

Tip

New to Huell? Start with Installation to get an instance running, then Configuration for the full settings reference.