hzel

Introduction

Documentation for the hzel container management platform.

hzel docs

hzel is a container management platform built on Proxmox VE. It provides a clean REST API and dashboard for provisioning, managing, and accessing unprivileged LXC containers — with a focus on security, auditability, and a straightforward developer experience.

What's in these docs

SectionWhat's inside
GuidesQuickstart, authentication flows, PAT setup
ConceptsPlatform architecture, container lifecycle, security model
ReferenceWebSocket endpoints, API error codes

Tip

New here? Head to the Quickstart to make your first API call in under two minutes.

Base URL

All API requests target:

https://api.hzel.org/api/v1

How it works

  1. Authenticate via OAuth or a Personal Access Token.
  2. Call the REST API to create and manage containers.
  3. Stream terminal sessions and command output over WebSockets.
  4. Every action is ownership-checked and audit-logged.

Read the Architecture overview to understand how the layers fit together.