Skip to content

Add Docker GPU support and deployment docs - #279

Merged
dreamlessx merged 1 commit into
mainfrom
docs/docker-gpu
Mar 15, 2026
Merged

dreamlessx merged 1 commit into
mainfrom
docs/docker-gpu

Conversation

@dreamlessx

Copy link
Copy Markdown
Owner

Summary

  • Add Dockerfile.gpu based on nvidia/cuda:12.1.1-runtime-ubuntu22.04 for GPU inference with a smaller image footprint than the existing devel-based Dockerfile
  • Add gpu service to docker-compose.yml on port 7861, keeping the existing app-gpu service for backward compatibility
  • Add docs/docker-gpu.md with comprehensive GPU Docker setup guide covering NVIDIA Container Toolkit installation, VRAM requirements by GPU tier (8GB/12GB/24GB+), verification steps, multi-GPU configuration, and troubleshooting
  • Update README, docs/index.md, docs/install.md, and docs/tutorials/deployment.md to reference the new GPU guide

Closes #232

Test plan

  • docker build -f Dockerfile.gpu -t landmarkdiff:gpu . builds successfully
  • docker compose up gpu starts the GPU service on port 7861
  • docker run --gpus all landmarkdiff:gpu python -c "import torch; print(torch.cuda.is_available())" returns True
  • Links in README, install.md, index.md, and deployment.md resolve correctly
  • docs/docker-gpu.md renders properly in Sphinx/GitHub

- Add Dockerfile.gpu using nvidia/cuda:12.1.1-runtime for smaller image
- Add gpu service to docker-compose.yml on port 7861
- Add docs/docker-gpu.md covering prerequisites, NVIDIA Container Toolkit
  installation, VRAM requirements by GPU tier, verification, troubleshooting
- Update README, docs/index.md, docs/install.md, tutorials/deployment.md
  to reference GPU Docker setup

Closes #232
@codecov

codecov Bot commented Mar 15, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@dreamlessx
dreamlessx merged commit 7666d9f into main Mar 15, 2026
8 checks passed
@dreamlessx
dreamlessx deleted the docs/docker-gpu branch March 15, 2026 03:53
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.

Add Docker GPU support documentation

1 participant