Skip to content
llama.cpp Server logo
ContainerUpdateableUnprivilegedDebian 13AI / Coding & Dev-Tools

llama.cpp Server

llama.cpp is a high-performance LLM inference server with OpenAI-compatible API. This installation uses the Vulkan backend for GPU acceleration across AMD, Intel, and NVIDIA GPUs. Features automatic model downloading from HuggingFace, built-in web UI, and supports multiple concurrent requests.

Install

bash -c "$(curl -fsSL https://raw.githubusercontent.com/Heretek-AI/ProxmoxVE/main/ct/llamacpp.sh)"

Run as root in the Proxmox VE shell. Pick Default for the sizing below, or Advanced to choose storage, network and resources yourself.

Notes

  • Warning: Requires GPU passthrough - configure in Proxmox before starting container
  • Warning: AMD GPU: Add 'dev0: /dev/kfd,gid=104' and 'dev1: /dev/dri/renderD128,gid=104' to container config
  • Warning: Intel GPU: Add 'dev0: /dev/dri/renderD128,gid=104' to container config
  • Warning: NVIDIA GPU: Requires nvidia-container-toolkit on host
  • Access the Web UI at http://<IP>:8080
  • OpenAI-Compatible API: http://<IP>:8080/v1/chat/completions
  • Default model: unsloth/Qwen3.5-9B-GGUF:Q8_0 (auto-downloaded on first start)
  • Models are stored in /opt/llamacpp/models/
  • Change model: Edit /etc/systemd/system/llamacpp.service and restart
  • GPU passthrough guide: /opt/llamacpp/GPU_PASSTHROUGH.md

What's new upstream

Fetching releases from GitHub…

Script details

Type
Container
Runs in
Proxmox VE shell
Added
11 Mar 2026
Slug
llamacpp
Container script
View
Install script
View
Metadata JSON
View
Last change
…