KoboldCpp
★ 12.2kA self-hosted alternative to Chatgpt
About
Community Ratings
No ratings yetNew this week
Read recap →Features
- single-file executable
- CPU or GPU inference
- LLM text generation
- image generation and editing
- video generation
- speech-to-text
- text-to-speech
- music generation
- image recognition
- MCP server support and tool calling
Details
- Last Updated
- Nov 5, 2026
- Created
- Mar 16, 2023
- Install Methods
- dockerbinarysource
- Requirements
- GGUF modelsNvidia GPU (for CUDA support)AMD GPUX11 (for the Linux GUI script)curlbzip2conda
- Default Port
- 5001web UI and API
- API
- REST
- Backup & Export
- native-exportfile-backup
- Privacy & Independence
- Cloud: OptionalOffline Capable
- Theming
- Custom themes
- Deployment
Deployment: Docker Compose ✓Single Container — minimal hosting footprintsingle container
Run KoboldCpp yourself
Pick how much you want to manage.
netcupBest match
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
Hetzner
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
DigitalOcean
Full control
A small server, then Docker Compose.
About 20 minutes with Docker
1 more way to host
Some links earn us a commission. netcup pays us one and is our preferred VPS host.
Is this your project? Sponsor a listing
Run KoboldCpp with Docker Compose
Compose file from the KoboldCpp project repository.
1 service
no resource limits declared
needs persistent storage (1 volume)
examples/docker-reference/docker-compose.yml · @ bf9b9bd · scanned Nov 3, 2026
version: "3.2"
services:
koboldcpp:
container_name: koboldcpp
image: koboldai/koboldcpp:latest
security_opt:
- apparmor:unconfined # AppArmor breaks sockets, don't worry everything is securely confined within docker
volumes:
- ./kcpp-data:/workspace/:rw
# devices: # Uncomment this section to add support for AMD/Intel GPU's
# - /dev/dri:/dev/dri
deploy: # You can remove this section if you do not wish to use an Nvidia GPU
resources:
reservations:
devices:
- driver: nvidia
device_ids: ['0']
capabilities: [gpu]
environment:
- KCPP_DONT_UPDATE=false
- KCPP_DONT_TUNNEL=true
- KCPP_ARGS=--model https://huggingface.co/unsloth/gemma-3-4b-it-GGUF/resolve/main/gemma-3-4b-it-Q4_K_S.gguf?download=true --gpulayers 99 --multiuser 20 --admin --admindir . --adminpassword ChangeMe # For split models in the 00001-of format specify the first file as the --model, remove --gpulayers 99 --multiuser 20 if you do not have a GPU
# Don't forget to change the model for production, the default model was chosen to fit on many systems rather than for its quality.
ports:
- "5001:5001"
restart: unless-stopped
This file may be out of date. Check the KoboldCpp documentation for current setup steps.
Tags
Track your self-hosted stack
Bookmark software to try, rate tools you've used, and keep your collection in one place.
Alternatives to KoboldCpp
Text Generation Inference
LocalAI
text-generation-webui
Ollama
GPT4All
llamafile
vLLM
Related Software
SillyTavern
LLM Harbor
