DEV Community

Uhltak Therestismysecret
Uhltak Therestismysecret

Posted on

Lokale LLMs mit Ollama – Modelle selbst hosten und per API anbinden

#ollama #llm #selfhosting #api

Lokale LLMs mit Ollama – Modelle selbst hosten und per API anbinden

"Warum ein Cloud‑Dienst, wenn du dieselbe Power in deinem Keller haben kannst? – Das ist nicht nur ein Tech‑Motto, sondern mittlerweile ein realistisches Sicherheits‑ und Kosten‑Mantra. In diesem Beitrag zeige ich dir, wie du mit Ollama deine Lieblings‑LLMs (Large Language Models) komplett offline betreibst, über eine einfache REST‑API ansprechst und dabei Ressourcen‑ und Sicherheitsaspekte im Griff behältst. Der Text ist gespickt mit echten Befehlen, Konfigurations‑Snippets und meiner persönlichen Einschätzung – kein Fülltext, nur handfeste Anleitungen.

Was ist Ollama und warum sollte man es nutzen?

Erklärung: Ollama ist ein open‑source Daemon, der große Sprach‑Modelle (LLMs) lokal ausführt und über eine einheitliche HTTP‑API bereitstellt. Anders als traditionelle Container‑Lösungen übernimmt Ollama das Laden, Cachen und Quantisieren von Modellen und kümmert sich um Speicher‑Management. Das bedeutet: Du musst nicht jedes Mal ein Docker‑Image bauen, das Modell‑Weight‑File manuell mounten und einen eigenen Inferenz‑Server schreiben. Ollama erledigt das in einem einzigen Prozess.

Beispiel: Nach Installation startest du den Daemon mit:

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install -y curl gnupg
curl -fsSL https://ollama.com/install.sh | sh

# Start des Daemons (systemd)
sudo systemctl enable --now ollama
Enter fullscreen mode Exit fullscreen mode

Der Daemon lauscht standardmäßig auf localhost:11434 und akzeptiert POST‑Requests im JSON‑Format.

Einschätzung: Die größte Stärke von Ollama liegt in seiner Einfachheit. Man spare Zeit, weil keine separate Python‑Umgebung, kein Torch‑Build und keine CUDA‑Konfiguration nötig sind. Für Unternehmen, die Datenhoheit verlangen, ist das ein entscheidender Pluspunkt – das Modell läuft komplett hinter der eigenen Firewall und muss nie das Rechenzentrum verlassen.

Installation und erstes Modell – Schritt für Schritt

Erklärung: Der Installationsprozess ist bewusst minimal gehalten. Neben dem Daemon benötigen wir lediglich ein Model‑Repository, das Ollama versteht (z. B. llama.cpp‑ kompatible GGUF‑Dateien). Das erste Modell kann direkt aus dem offiziellen Ollama‑Hub gezogen werden.

Beispiel 1 – Modell herunterladen und starten:

# Liste aller verfügbaren Modelle
ollama list models

# Pull des kleineren Llama‑2‑7b‑Chat‑Q4‑Quantized Modells
ollama pull llama2:7b-chat-q4

# Test‑Run: ein einfaches Prompt
curl -X POST http://localhost:11434/api/generate \
  -H 'Content-Type: application/json' \
  -d '{"model":"llama2:7b-chat-q4","prompt":"Erkläre mir kurz den Unterschied zwischen TCP und QUIC.","stream":false}'
Enter fullscreen mode Exit fullscreen mode

Der Rückgabewert ist ein JSON‑Objekt mit dem generierten Text. Für die ersten Tests reicht ein kleiner Quantisierungs‑Level (Q4) aus – das reduziert RAM‑Bedarf auf ~5 GB bei akzeptabler Qualität.

Beispiel 2 – Persistente Konfiguration (systemd‑Service‑Overrides):

# /etc/systemd/system/ollama.service.d/override.conf
[Service]
# Begrenze den Speicher auf 8 GB, um OOM‑Kills zu verhindern
MemoryLimit=8G
# Setze ein Log‑Level für detailliertes Debugging
Environment=OLLAMA_LOG=debug
Enter fullscreen mode Exit fullscreen mode

Nach dem Speichern: sudo systemctl daemon-reload && sudo systemctl restart ollama.

Einschätzung: Der Daemon läuft problemlos auf gängigen Server‑CPU‑Architekturen (x86_64, ARM64). Für homelab‑Umgebungen kann man sogar auf einem Raspberry Pi 4 (8 GB) ein 3‑Billion‑Parameter‑Modell testen – allerdings mit höherem Quantisierungs‑Level (Q8_0) und etwas Langsamkeit. In produktiven Umgebungen empfehle ich jedoch mindestens 16 GB RAM für ein 7‑Billion‑Parameter‑Modell.

Modelle verwalten – Pull, Update und eigene Quantisierung

Erklärung: Ollama bietet drei Kernbefehle: pull, list und rm. Zusätzlich kann man eigene GGUF‑Dateien importieren, wenn man zum Beispiel ein proprietäres Modell aus einer internen Pipeline hat.

Beispiel 3 – Eigenes Modell importieren:

# Angenommen, du hast ein quantisiertes GGUF‑File "my‑model‑q4.gguf" im Verzeichnis /opt/models
ollama import /opt/models/my-model-q4.gguf my-company/model:1.0

# Prüfen, ob das Modell registriert ist
ollama list models | grep my-company
Enter fullscreen mode Exit fullscreen mode

Nun ist das Modell über die gleiche API ansprechbar wie jedes andere.

Beispiel 4 – Automatischer Update‑Job (cron):

# Jeden Sonntag um 03:00 Uhr das neueste Llama‑2‑Chat‑Modell pullen
0 3 * * 0 /usr/local/bin/ollama pull llama2:7b-chat-q4 > /var/log/ollama-update.log 2>&1
Enter fullscreen mode Exit fullscreen mode

Durch das regelmäßige Pullen bleibt das lokale Modell immer auf dem neuesten Stand – ohne dass du manuell eingreifen musst.

Einschätzung: Der größte Stolperstein ist das Version‑Management. Wenn du mehrere Modelle parallel nutzt, solltest du klare Namenskonventionen (z. B. my-company/model:2024‑09) einführen. So lässt sich später problemlos zwischen Produktions‑ und Test‑Instanzen schalten.

API‑Anbindung – Von Curl bis Python‑Client

Erklärung: Ollama stellt eine minimale, aber leistungsfähige HTTP‑API bereit. Die Endpunkte generate, embed und list decken die meisten Anwendungsfälle ab. Für Entwickler gibt es offizielle SDKs für Go, Python und JavaScript, die intern fetch bzw. requests benutzen.

Beispiel 5 – Curl‑Aufruf (wie oben) mit Streaming‑Antwort:

curl -N -X POST http://localhost:11434/api/generate \
  -H 'Content-Type: application/json' \
  -d '{"model":"llama2:7b-chat-q4","prompt":"Schreibe ein Haiku über den Herbst.","stream":true}'
Enter fullscreen mode Exit fullscreen mode

Der Schalter -N verhindert das Puffer‑Caching, sodass Zeile für Zeile der Text zurückkommt.

Beispiel 6 – Python‑Wrapper (requests):

import requests, json

url = "http://localhost:11434/api/generate"
payload = {
    "model": "llama2:7b-chat-q4",
    "prompt": "Wie lässt sich ein Zero‑Trust‑Netzwerk per Bash‑Script aufbauen?",
    "stream": False,
}
resp = requests.post(url, json=payload)
print(json.loads(resp.text)["response"])
Enter fullscreen mode Exit fullscreen mode

Damit lässt sich das LLM direkt in CI‑Pipelines, Chat‑Bots oder Monitoring‑Alarme einbinden.

Beispiel 7 – Embedding‑Endpoint für Retrieval‑Augmented Generation (RAG):

curl -X POST http://localhost:11434/api/embed \
  -H 'Content-Type: application/json' \
  -d '{"model":"llama2:7b-chat-q4","input":"Die DSGVO verlangt eine Datenminimierung.","encoding":"float32"}'
Enter fullscreen mode Exit fullscreen mode

Der zurückgelieferte Vektor kann in einer lokalen FAISS‑Instanz für semantische Suche verwendet werden.

Einschätzung: Die API‑Design‑Philosophie von Ollama erinnert stark an OpenAI’s REST‑Schnittstelle – das ist ein bewusster Schritt, um den Umstieg von Cloud‑ zu On‑Premise‑Lösungen zu erleichtern. Der einzige Nachteil ist das Fehlen von Auth‑Mechanismen; in produktiven Szenarien sollte man einen Reverse‑Proxy (z. B. Nginx) mit HTTP‑Basic oder Mutual TLS fronten.

Optimierung für Produktivbetrieb – RAM, Quantisierung & Parallelität

Erklärung: Während die Grundinstallation bereits ausreicht, um ein Modell zu starten, stoßen Unternehmen schnell an ihre Grenzen, wenn mehrere gleichzeitige Anfragen verarbeitet werden sollen. Zwei Schlüsselparameter steuern das Verhalten: max_context (Kontext‑Länge) und num_threads (CPU‑Parallelausführung).

Beispiel 8 – Konfigurations‑Datei ollama.yaml (Pfad /etc/ollama/ollama.yaml):

# Maximale Kontext‑Größe (Standard 4096 Tokens)
max_context: 8192
# CPU‑Threads – passt zu der Anzahl physischer Kerne
num_threads: 12
# Log‑Level für Monitoring
log_level: info
# Optional: GPU‑Beschleunigung (falls CUDA‑Kompatibel)
# gpu: true
Enter fullscreen mode Exit fullscreen mode

Nach Änderungen: sudo systemctl restart ollama.

Beispiel 9 – Modell‑Requantisierung mit ollama quantize (nur bei selbst importierten GGUF‑Files):

ollama quantize /opt/models/my-model.q8.gguf my-model:q4 --target q4
Enter fullscreen mode Exit fullscreen mode

Damit schrumpft der RAM‑Footprint um bis zu 50 %, was bei begrenzten Ressourcen entscheidend ist.

Beispiel 10 – GPU‑Enable (nur NVIDIA‑Systeme):

# Installiere CUDA‑Toolkit (Ubuntu 22.04 Beispiel)
sudo apt-get install -y nvidia-driver-525 cuda-toolkit-12-2

# Aktiviere GPU‑Modus in config
sudo sed -i 's/# gpu: false/gpu: true/' /etc/ollama/ollama.yaml
sudo systemctl restart ollama
Enter fullscreen mode Exit fullscreen mode

Jetzt kann das Modell die Inferenz‑Zeit von ~2 s pro Anfrage auf ~0,4 s reduzieren.

Einschätzung: Der entscheidende Hebel ist die Quantisierung. Für interaktive Chat‑Bots reicht Q4 meistens, während für anspruchsvolle Code‑Generierung Q5 oder Q6 bessere Resultate liefern. Parallelität sollte immer an die physischen Kerne angepasst werden – ein zu hoher num_threads führt zu Kontext‑Switch‑Overhead und letztlich zu höheren Latenzzeiten.

Häufige Fehler und wie man sie vermeidet

  1. Kein RAM‑Reserve – Das Modell scheitert bei ersten Anfragen mit OOMKilled. Lösung: Setze MemoryLimit im systemd‑Service und überwache mit systemd-cgtop.
  2. Version‑Mix‑Up – Pull‑Befehl überschreibt ein bereits produktives Modell. Lösung: Verwende eindeutige Tags (mymodel:prod-2024) und prüfe mit ollama list.
  3. Keine Auth‑Schicht – Externe Angreifer können das lokale API ansteuern, falls das Netzwerk nicht isoliert ist. Lösung: Setze Nginx als Reverse‑Proxy mit auth_basic oder Mutual TLS.
  4. Quantisierung zu aggressiv – Q8‑Mode kann bei 7‑B-Modell zu erheblichen Qualitätsverlusten führen. Lösung: Teste das Modell zuerst im Q4‑Modus und steigere nur bei Bedarf.
  5. GPU‑Fehlkonfiguration – Ohne passende CUDA‑Version startet Ollama im CPU‑Modus, aber das Log zeigt gpu: true – Verwirrend für Fehlersuche. Lösung: Prüfe nvidia-smi und die ollama.yaml‑Einträge nach System‑Updates.

Fazit & konkreter nächster Schritt

Ollama macht das Hosting lokaler LLMs zu einer erreichbaren Aufgabe für Administratoren, Entwickler und Security‑Teams. Die Kombination aus einfacher Installation, einheitlicher API und automatischer Modell‑Quantisierung bedeutet: Du sparst sowohl Kosten (keine Cloud‑Abrechnung) als auch Datenschutz‑Risiken (Modelle bleiben im eigenen Netzwerk). Die häufigsten Stolpersteine – RAM‑Limit, fehlende Authentifizierung und unbedachte Quantisierung – lassen sich durch klare Prozesse und ein paar Zeilen Konfiguration elegant aus dem Weg räumen.

Nächster Schritt: Setze heute folgendes um:

  1. Installiere Ollama auf deinem Test‑Server (Befehl aus Abschnitt 2).
  2. Pull das llama2:7b-chat-q4‑Modell.
  3. Erstelle die ollama.yaml‑Datei mit max_context: 8192 und num_threads passend zu deiner CPU.
  4. Baue einen Nginx‑Reverse‑Proxy mit HTTP‑Basic‑Auth, um das API öffentlich abzusichern.
  5. Schreibe ein kurzes Python‑Skript, das das Modell für deine internen Ticket‑Bots nutzt.

Damit hast du innerhalb weniger Stunden ein komplett eigenständiges LLM‑System, das sowohl Sicherheit als auch Performance liefert – und das ganz ohne externe Anbieter.

Top comments (0)