Monorepo for Aesthetic.Computer aesthetic.computer
core false.work unreal-builder docs HARDWARE-SPECS.md
5.3 kB

Hardware Specifications & UE5 Compatibility #

🖥️ Current VM Configuration #

Machine Type: n2-standard-8

  • CPU: 8 vCPUs (Intel Cascade Lake)
  • RAM: 32 GB
  • Disk: 300GB SSD (pd-ssd)
  • GPU: ❌ None (software rendering only)
  • OS: Windows Server 2022

Cost: ~$200-250/month (24/7) or ~$80-100/month (8hrs/day weekdays)


✅ UE5 Build Requirements (Met) #

For automated builds (no editor, no viewport), you need:

Minimum: #

  • ✅ CPU: Quad-core Intel/AMD, 2.5+ GHz → We have: 8-core, 2.8+ GHz
  • ✅ RAM: 16 GB → We have: 32 GB
  • ✅ Storage: 100GB+ SSD → We have: 300GB SSD
  • ⚠️ GPU: Not required for command-line builds

Our Status: #

  • ✅ CPU: n2-standard-8 is MORE than enough (8 cores > 4 required)
  • ✅ RAM: 32GB is DOUBLE the minimum (16GB)
  • ✅ Disk: Fast SSD, plenty of space
  • ⚠️ GPU: None, but NOT NEEDED for automated builds

🎮 GPU Considerations #

Do We Need a GPU? #

For automated builds: NO ✅

  • RunUAT.bat (build automation) doesn't need GPU
  • UnrealBuildTool compiles C++ without GPU
  • Cooking assets works fine on CPU
  • Packaging uses CPU only

For interactive editing: YES ❌

  • UE5 Editor needs GPU for viewport rendering
  • But we're NOT running the editor!

Current Setup: #

  • No GPU attached (saves ~$200-400/month)
  • Builds will run using software rendering
  • Perfectly fine for CI/CD pipelines

If You Ever Need GPU: #

Change machine type to add GPU:

# Stop VM
gcloud compute instances stop ue5-builder-falsework --zone=us-central1-a

# Add NVIDIA T4 GPU (~$100-150/month extra)
gcloud compute instances attach-disk ue5-builder-falsework \
  --disk-type=pd-ssd \
  --zone=us-central1-a

gcloud compute instances set-machine-type ue5-builder-falsework \
  --machine-type=n1-standard-8 \
  --zone=us-central1-a

gcloud compute instances attach-accelerator ue5-builder-falsework \
  --accelerator-type=nvidia-tesla-t4 \
  --accelerator-count=1 \
  --zone=us-central1-a

# Start VM
gcloud compute instances start ue5-builder-falsework --zone=us-central1-a

GPU Options & Costs:

  • NVIDIA T4: ~$100-150/month (good for most work)
  • NVIDIA V100: ~$700-800/month (overkill for builds)
  • NVIDIA A100: ~$2000+/month (extreme overkill)

📊 Performance Expectations #

Build Times (CPU-only): #

Current Setup (8 cores, no GPU):

  • Full clean build: 30-60 minutes
  • Incremental build: 5-15 minutes
  • Cooking: 10-20 minutes
  • Packaging: 5-10 minutes

If You Add GPU:

  • Same times! (GPU doesn't help build/cook)
  • Only helps if you run editor interactively

With Horde Distributed Builds:

  • Full clean build: 5-15 minutes (if you add more machines)
  • Requires 2+ build machines

🔍 Verification Steps #

Once you're in the VM, check the hardware:

# Check CPU
Get-WmiObject Win32_Processor | Select-Object Name, NumberOfCores, NumberOfLogicalProcessors

# Check RAM
Get-WmiObject Win32_ComputerSystem | Select-Object @{Name="RAM (GB)";Expression={[math]::Round($_.TotalPhysicalMemory/1GB,2)}}

# Check disk
Get-PSDrive C | Select-Object Used, Free, @{Name="Size (GB)";Expression={[math]::Round($_.Used/1GB + $_.Free/1GB,2)}}

# Check for GPU
Get-WmiObject Win32_VideoController | Select-Object Name, AdapterRAM

# System info
systeminfo | findstr /B /C:"OS Name" /C:"System Type" /C:"Processor"

Expected Output:

  • CPU: Intel Xeon (Cascade Lake), 8 cores
  • RAM: 32 GB
  • GPU: "Microsoft Basic Display Adapter" (no hardware GPU)
  • This is FINE for builds! ✅

🎯 Recommendation #

Keep Current Configuration ✅ #

Reasons:

  1. ✅ CPU is more than powerful enough (8 cores)
  2. ✅ RAM is double the requirement (32GB)
  3. ✅ Builds don't need GPU
  4. ✅ Saves $200-400/month vs GPU instance
  5. ✅ Fast SSD for disk I/O

When to Upgrade: #

Add GPU only if:

  • ❌ You want to RDP in and use UE5 Editor interactively
  • ❌ You need to test rendering/graphics (unlikely for CI/CD)
  • ❌ You want to run game tests with actual rendering

For just builds: Current setup is perfect! 🎯


🚨 Real-World Check #

After bootstrap completes and UE5 installs, run a test build and see:

  • If it completes successfully ✅
  • How long it takes ⏱️
  • If you get memory errors (unlikely with 32GB) ❌

If builds fail due to hardware, we can upgrade. But 99% certain they'll work fine!


💰 Cost Comparison #

Configuration Monthly Cost (24/7) Monthly Cost (8hrs/weekday)
Current (CPU only) $200-250 $80-100
With T4 GPU $350-400 $160-200
With V100 GPU $900-1000 $450-500

Verdict: Keep current setup until you have a reason to change! 💸


📝 Summary #

Your VM is perfectly capable of UE5 builds:

  • ✅ 8 CPU cores (UE5 builds are CPU-intensive)
  • ✅ 32GB RAM (plenty for parallel compilation)
  • ✅ 300GB SSD (fast I/O for large projects)
  • ⚠️ No GPU (not needed for command-line builds)

Test it first, upgrade only if needed! 🚀

The lack of GPU will NOT prevent builds from working. It only matters for interactive editor use or running the actual game with rendering.