Skip to main content

​
HYPR Documentation

HYPR is a microVM orchestration platform that runs OCI container images as lightweight virtual machines.

​
What is HYPR?

HYPR bridges the gap between containers and virtual machines. It takes standard container images from any OCI registry and boots them as isolated microVMs with their own Linux kernel. This provides hardware-level isolation while maintaining the developer experience of containers. Each VM runs:
  • A minimal Linux kernel (6.12) with essential drivers
  • A guest agent (Kestrel) as PID 1
  • The container rootfs as a read-only squashfs with overlayfs for writes

​
Why HYPR?

VM-Level Isolation: Each workload runs in its own virtual machine with separate kernel, memory, and CPU allocation. Kernel vulnerabilities in one VM cannot affect others. Container Ergonomics: Use the same images, Dockerfiles, and compose files you already have. No new formats to learn. Networking: Create isolated networks with custom CIDR ranges. Services in the same network can communicate by name. Volumes: Persistent named volumes and bind mounts work the same as Docker. GPU Support: Pass GPUs through to VMs for ML/AI workloads. Supports NVIDIA/AMD via VFIO on Linux and Metal on Apple Silicon. Fast Boot Times: Optimized kernel and guest agent enable sub-second VM boot times.

​
Documentation Sections

​
Getting Started

​
Core Concepts

​
Infrastructure

​
Advanced

​
Operations

​
Platform Support

PlatformArchitectureHypervisorGPU Support
Linuxx86_64cloud-hypervisorVFIO
LinuxARM64cloud-hypervisorVFIO
macOSApple SiliconlibkrunMetal
macOSIntellibkrunNone

​
Quick Example

# Install HYPR
curl -fsSL https://get.hypr.tech | sh

# Run nginx with port mapping
hypr run nginx -p 8080:80

# Check running VMs
hypr ps

# View logs
hypr logs <vm-id> -f

# Execute command in VM
hypr exec <vm-id> -- cat /etc/nginx/nginx.conf

# Stop and remove
hypr stop <vm-id>
hypr rm <vm-id>

​
Multi-Service Example

# docker-compose.yml
services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html
    networks:
      - frontend

  api:
    image: myapi:latest
    networks:
      - frontend
      - backend
    depends_on:
      - db

  db:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: secret
    volumes:
      - pgdata:/var/lib/postgresql/data
    networks:
      - backend

volumes:
  pgdata:

networks:
  frontend:
  backend:

# Deploy the stack
hypr compose up -d

# Check status
hypr compose ps

# Tear down
hypr compose down mystack

​
License

HYPR is licensed under the Business Source License 1.1 (BSL-1.1).