Skip to content

COVEROQ CAD Platform - System Requirements & Environment Prerequisites

Document Metadata
🗓️ Last Modified: 2026-09-29
👤 Author / Owner: @JakubDedik & @Jules
🏷️ Status: Active Reference
🔗 Linked System Component: Hetzner Host, Local Worker Environment (pc-jakub), FreeCAD 1.1 Binaries

This document outlines the hardware, operating system, and software prerequisites required to run the COVEROQ CAD Platform configurator ecosystem.

1. Hardware Specifications

Because FreeCAD geometry recomputes are single-thread intensive, CPU clock speed (single-core performance) is more critical than a high core count.

Minimum Requirements (For Small Assemblies / Low Traffic)

  • CPU: Dual-Core Intel Xeon / AMD EPYC (or cloud equivalent with 2 vCPUs)
  • RAM: 8 GB DDR4 (Allows 4 GB for FreeCAD CAD operations, 1 GB for API/Web/DB, and 3 GB system overhead)
  • Storage: 30 GB SSD (NVMe preferred for fast CAD document loading and I/O operations)
  • GPU: Not Required (Mesa CPU software rendering handles headless exports)
  • CPU: Quad-Core AMD EPYC / Intel Xeon (or high-compute cloud instance with 4 vCPUs, >= 3.6 GHz base clock)
  • RAM: 16 GB DDR4/DDR5 (Allows 8 GB for concurrent CAD exports, 2 GB for API/Web/DB, and 6 GB system headroom)
  • Storage: 50+ GB NVMe M.2 SSD (High-speed storage reduces template loading times)
  • GPU: Hardware GPU (e.g. NVIDIA GTX 1050 Ti or higher) for hardware-accelerated Coin3D viewport operations

2. Verified Hardware Specifications (pc-jakub Production Worker)

The dedicated CAD worker host pc-jakub runs as a high-efficiency on-premise CAD execution engine:

  • Host Name: pc-jakub (Ubuntu 26.04 LTS)
  • Processor (CPU): Intel Xeon E3-1271 v3 @ 3.60 GHz (Turbo 4.0 GHz, 4 Cores / 8 Threads)
  • RAM: 16 GB DDR3 (4× 4GB @ 1600 MT/s)
  • GPU: NVIDIA GeForce GTX 1050 Ti (4 GB GDDR5, hardware OpenGL rendering)
  • Storage: 960 GB Kingston A400 SSD (SATA III 6.0 Gb/s)
  • Measured Power Consumption:
    • Idle / Standby: ~50 – 55 W (CPU package @ ~24 W, GPU @ ~6 W)
    • Average Active CAD Workload: ~60 – 70 W
    • Peak Full Load (CI & 3D Render): ~130 – 150 W

3. Software Stack Requirements

A. Runtime Environments

  • .NET 10 SDK & Runtime: Version 10.0+ (Required for Coveroq.Cad.Worker, Coveroq.Cad.Api, and GitHub Actions CI runner)
  • Python 3.11 (Conda/Miniforge3): Required strictly for FreeCAD 1.1.0 embedded geometry operations (cad-env)
  • Node.js & npm (v18+): Required for WebApp build, Vitest test suite, and contract generation
  • Docker & Docker Buildx: Used for local CI smoke tests and isolated container builds

B. Display Environment (For Qt / Viewport Off-Screen Rendering)

  • Display Server: Xorg on display :0 (/var/run/lightdm/root/:0)
  • OpenGL Support: Dedicated NVIDIA proprietary/open drivers for accelerated Coin3D viewport operations

C. Systemd Services on pc-jakub

  • actions.runner.COVEROQ-3D-platforma.pc-jakub-runner.service: Continuous Integration & Deployment runner
  • coveroq-cad-worker.service: Production .NET 10 CAD Worker daemon (/opt/coveroq-worker/Coveroq.Cad.Worker)
  • docker.service: Container engine for verification builds