- scripts/deploy.sh: target-aware deploy (dankclaw/dankserver). Pushes main, pulls on the target, installs/enables systemd unit, restarts service, and checks the health endpoint; --dry-run preview; pre-flight dirty-tree check - docs/deployment.md: full deployment/update process with mermaid workflow, target map, manual update commands, service units, and troubleshooting - AGENTS.md: add Deployment & Update Process section (deploy.sh usage, target map, mermaid workflow) and a Summary table row - docs/index.md: crosslink deployment doc
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# vLLM Scripts — Knowledge Base
|
|
|
|
Documentation for running vLLM inference on two local machines.
|
|
|
|
## Deployment Topology
|
|
|
|
```mermaid
|
|
graph LR
|
|
subgraph Dankserver[NVIDIA Dankserver - Ubuntu 24.04]
|
|
A[RTX 3090 24GB + 62GB RAM]
|
|
B[vLLM 0.26.0 in Podman\nvllm-qwen36-dflash]
|
|
C[Qwen3.6-35B-A3B-FP8\n+ DFlash draft, port 8000]
|
|
A --> B --> C
|
|
end
|
|
|
|
subgraph Dankclaw[AMD Strix Halo - Ubuntu 26.04]
|
|
D[gfx1151 APU 30GiB phys / 96GiB GPU-visible]
|
|
E[ROCmFPX llama.cpp\n/ROCmFPX/build-strix-rocmfp4]
|
|
F[Ling-3.0-flash ROCmFP4-MTP\ndraft-mtp, port 8080]
|
|
D --> E --> F
|
|
end
|
|
|
|
G[LLM Clients / API] -->|HTTP :8000| B
|
|
G -->|HTTP :8080| E
|
|
```
|
|
|
|
## Servers
|
|
|
|
| Server | GPU | VRAM / Memory | OS |
|
|
| --------------------------------------- | ----------------------------- | ----------------------------------- | ------------ |
|
|
| [[Dankserver System Specs\|Dankserver]] | NVIDIA RTX 3090 | 24 GB VRAM, 62 GB RAM | Ubuntu 24.04 |
|
|
| [[Dankclaw System Specs\|Dankclaw]] | AMD Radeon 8060S (Strix Halo) | 30 GiB physical / 96 GiB GPU-visible | Ubuntu 26.04 |
|
|
|
|
## vLLM Reference
|
|
|
|
- [[VLLM Overview]] — installation, CLI, API, architecture, quantization, parallelism
|
|
- [[VLLM Index]] — quick reference with commands, endpoints, and parameter table
|
|
- [[deployment]] — deploy and update process for both servers
|
|
|
|
## Memory Management
|
|
|
|
- [[RAM CPU Offloading in VLLM]] — KV cache swap between GPU VRAM and system RAM
|
|
- [[Hybrid CPU GPU Processing Dankserver]] — NVIDIA GPU compute with system RAM offload
|
|
- [[Shared Memory Architecture Dankclaw]] — AMD unified memory and ROCm configuration
|
|
|
|
## Model Deployment
|
|
|
|
- [[Running Qwen3.6 35B A3B FP8 on Dankserver]] — MoE model (35B total, 3B active) on RTX 3090
|
|
- [[Running Qwen3.6 27B FP8 on Dankclaw]] — Dense model (27B) on Strix Halo APU
|