Coblyn System Architecture

⏱ 12 minNivel · IT Architectv1.16.0

Reference: This document provides a high-level overview. For deep technical details, refer to the internal documentation in docs/KNOWLEDGE-BASE.md.

System Overview

Coblyn is a containerized PXE deployment system designed for mass inventory and automated provisioning. It utilizes a 10-container Docker architecture integrated via a modular Storage Hub supporting NFS and SMB/CIFS with self-healing capabilities.

System Architecture Diagram

Container Details

1. DHCP Server (ISC Kea)

Purpose: Dynamic IP management through commands sent over a local Unix socket; Kea does not expose a REST API.

• Automatic Quarantine: New devices are isolated in their own range until approved.

2. Backend (FastAPI)

Purpose: System brain, database management, and NFS/SMB mount orchestration.

• Security: Uses nsenter to mount resources onto the host in an isolated manner.

PXE Boot Flow

---

Last Updated: 2026-05-13 (Surgery v1.16.0)