docs(llama-cpp): deployment detail goes back to the setup page

The overview page carried `docker run` invocations (including a CUDA variant, on a fleet with no
NVIDIA card left in it) and the `LLAMA_ARG_` environment rule, while `setup.md` — the page whose
own intro promises "build instructions, Docker, and systemd deployment" — carried the Compose
example and the same env form in use. Two places to look, one place to be wrong.

`setup.md` now states the env-prefix rule where the flags live (and why units prefer it: one
flag per line is auditable, a forty-flag command line is not), and the overview keeps only the
API surface and the GGUF format, pointing at the sections that absorbed the rest.

Refs #64
This commit is contained in:
Frank committed 2026-10-21 02:25:14 -07:00
1 parent 8b87b5ae1a
commit ec19771b8b
2 files changed
+11 -26

No files matched your search

+3 -26
View File
@@ -124,31 +124,8 @@ print(completion.choices[0].message.content)
---
## Docker
```bash
docker run -p 8080:8080 -v /models:/models \
ghcr.io/ggml-org/llama.cpp:server \
-m /models/model.gguf --host 0.0.0.0 --port 8080
# CUDA variant
docker run -p 8080:8080 --gpus all \
ghcr.io/ggml-org/llama.cpp:server-cuda \
-m /models/model.gguf --n-gpu-layers 99
```
---
## Environment Variables
All CLI options can be set via `LLAMA_ARG_` prefix:
```bash
LLAMA_ARG_MODEL=/models/model.gguf LLAMA_ARG_CTX_SIZE=8192 llama-server
```
---
## Cross-References
- See [Setup Guide](setup.md) for build instructions, GPU offloading, and deployment.
- See [Setup Guide](setup.md) for build instructions, GPU offloading, the `LLAMA_ARG_*`
environment form, the Docker Compose example, and running under systemd. Deployment lives
there; this page is the API surface and the GGUF format.
+8
View File
@@ -111,6 +111,14 @@ cmake --build build --config Release -t llama-server
| `-lora FNAME` | LoRA adapter (repeatable) | — |
| `-ngl, --gpu-layers N` | Layers to offload to GPU | auto |
### Environment Variables
Every CLI option can be set from the environment instead: prefix the upper-snake form of the
long flag with `LLAMA_ARG_` — `LLAMA_ARG_MODEL=/models/model.gguf LLAMA_ARG_CTX_SIZE=8192
llama-server`. This is how the container and systemd units pass configuration (see the Compose
example below), because a unit file with one flag per line is auditable and a shell command line
with forty is not.
### Context & Performance
| Flag | Description | Default |