Skip to content

Add troubleshooting section and fix common setup issues#1

Open
024dsun wants to merge 1 commit intoovg-project:mainfrom
024dsun:setup-improvements
Open

Add troubleshooting section and fix common setup issues#1
024dsun wants to merge 1 commit intoovg-project:mainfrom
024dsun:setup-improvements

Conversation

@024dsun
Copy link

@024dsun 024dsun commented Mar 2, 2026

Summary

This PR addresses common setup issues discovered during GVM installation on Ubuntu 24.04 GCP VMs.

Changes

  • README.md: Added comprehensive troubleshooting section with 6 common issues and fixes
  • .gitmodules: Changed submodule URLs from SSH to HTTPS to avoid authentication issues
  • setup: Fixed diffusion script to create output directory automatically
  • SUBMODULE_FIXES.md: Documented required changes for submodule repositories

Issues Fixed

  1. Git submodules fail to clone (SSH authentication)
  2. CUDA installation fails on kernel 6.8+
  3. Kernel module compilation fails on kernel 6.17+
  4. nvcc not found during CUDA intercept layer build
  5. HuggingFace gated model access denied
  6. Diffusion log file fails to save

Testing

All fixes have been tested on GCP VM with Ubuntu 24.04.4 LTS, kernel 6.8.0-1007-gcp, NVIDIA L4 GPU.

- Add comprehensive troubleshooting section to README with 6 common issues
- Change .gitmodules to use HTTPS URLs instead of SSH (fixes auth issues)
- Fix setup script to create diffusion_outputs directory automatically
- Add SUBMODULE_FIXES.md documenting required changes for submodules
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant