Inhaltsverzeichnis
- 1. Was ist Ollama? Zwei Wege: lokal und in der Cloud
- 2. Ollama installieren (Windows / macOS / Linux / Docker)
- 3. Läuft es schnell auf deiner GPU? (unterstützte GPUs im Überblick)
- 4. Ollama-Befehle im Überblick
- 5. Modelle laden und Tags lesen
- 6. Mit einer Oberfläche nutzen (Ollama-App, Open WebUI und mehr)
- 7. Cloud-Modelle und Preise
- 8. Die API nutzen (OpenAI- und Anthropic-kompatibel)
- 9. Anpassen (Modelfile, Umgebungsvariablen, Speicher-Tuning)
- 10. Fehlerbehebung
- Fazit
- FAQ
Ollama ist ein kostenloses Open-Source-Tool, mit dem du offene LLMs (große Sprachmodelle) auf deinem eigenen Rechner ausführst. Es läuft unter Windows, macOS und Linux, und eine einzige Zeile, ollama run modellname, erledigt alles vom Herunterladen des Modells bis zum Chat. Solange es läuft, lauscht ein API-Server auf localhost:11434 – deine eigenen Apps und Tools wie Claude Code können es also ebenfalls aufrufen. Neben Modellen, die auf deinem Rechner laufen, nutzt du mit denselben Befehlen inzwischen auch Cloud-Modelle, deren Name auf :cloud endet.
Diese Anleitung konzentriert sich darauf, wie man Ollama selbst benutzt, abgeglichen mit dem Originaltext des offiziellen GitHub-Repositorys (einschließlich des Quellcodes), der offiziellen Dokumentation und der Preisseite (Stand: 12. November 2026). Zu lokalen LLMs allgemein siehe wie du mit einem lokalen LLM startest, zur Modellwahl unseren großen Vergleich der besten lokalen LLM-Modelle, zur Berechnung des nötigen VRAM den Artikel zu den Hardware-Anforderungen und zur Anbindung an deinen Editor den Artikel zu Ollama + Cline.
Dieselben Befehle – lokal oder in der Cloud
— Vier Einstiege: App, Befehle, API und Integrationen starten
🖱️ Chatten in der App
⌨️ Befehle (CLI)
🔌 Lokale API
🚀 Integrationen starten
1. Was ist Ollama? Zwei Wege: lokal und in der Cloud
Ollama ist ein kostenloses Open-Source-Tool, mit dem du offene Modelle (Gemma, Qwen, gpt-oss und andere) ganz einfach auf deinem eigenen PC betreibst. Es erledigt den mühsamen Teil – das Herunterladen von Modellen, den Umgang mit Quantisierungsformaten, die Konfiguration der GPU-Nutzung – im Hintergrund, sodass du nur noch „ein Modell benennen und ausführen“ musst. Die Inferenz baut auf llama.cpp auf; auf Macs mit Apple Silicon gibt es manche Modelle zusätzlich in Versionen, die auf Apples MLX laufen.
💡 Kurz gesagt: Ollama ist „Docker für LLMs“. Hol dir ein Modell mit ollama pull, chatte mit ollama run. Außerdem startet es einen lokalen API-Server, sodass auch deine eigenen Apps, Chat-Oberflächen und Coding-Agenten es ansprechen können.
Es gibt zwei Arten, ein Modell auszuführen – und je nachdem, welche du wählst, ändern sich der nötige Rechner und die Kosten grundlegend.
Lokal
ollama run gemma4
- Lädt das Modell auf deinen PC und führt es dort aus
- Unbegrenzt nutzbar ohne Gebühren (abgesehen vom Strom)
- Die Geschwindigkeit hängt von GPU und VRAM ab
- Deine Eingaben verlassen den PC nicht
Cloud
ollama run gemma4:cloud
- Läuft auf den Servern von Ollama (kein Download)
- Abrechnung pro Token oder über das Guthaben eines Monatsplans
- Große Modelle sind auch auf einem PC ohne GPU schnell
- Deine Eingaben werden auf den Servern von Ollama verarbeitet
Ein ähnliches Werkzeug ist LM Studio. Grob gesagt: Ollama = rund um Befehle und API gebaut, für Entwickler, Automatisierung und die Anbindung von Agenten; LM Studio = rund um eine Oberfläche gebaut, für alle, die von der Modellsuche bis zum Chat im selben Fenster bleiben wollen. Beide sind kostenlos. Die Unterschiede zwischen lokal und Cloud selbst (Kosten, Leistung, Datenschutz) behandelt unser Vergleich lokaler und Cloud-LLMs.
2. Ollama installieren (Windows / macOS / Linux / Docker)
Die offizielle Download-Seite und das README auf GitHub bieten für jedes Betriebssystem zwei Wege: einen Einzeiler, den du ins Terminal kopierst, oder ein manuelles Installationsprogramm. Beide führen zum selben Ergebnis.
| OS | Installation per Einzeiler (Wortlaut der offiziellen Seite) | Voraussetzungen |
|---|---|---|
| Windows | In der PowerShell: irm https://ollama.com/install.ps1 | iex |
Windows 10 22H2 oder neuer (Home / Pro), keine Administratorrechte nötig, mindestens 4 GB frei allein für das Programm |
| macOS | curl -fsSL https://ollama.com/install.sh | sh |
macOS 14 Sonoma oder neuer, Apple-M-Chips nutzen CPU und GPU, Intel-Macs nur die CPU |
| Linux | curl -fsSL https://ollama.com/install.sh | sh |
Für Updates dieselbe Zeile erneut ausführen, Zusatzpaket für AMD-GPUs |
Windows
Wenn du lieber ohne Befehl arbeitest, lade OllamaSetup.exe von der Download-Seite und starte es. Laut der offiziellen Windows-Seite landet die Installation standardmäßig in deinem Benutzerordner, und die Modelle können Dutzende bis Hunderte GB dazu belegen. Ist auf Laufwerk C: wenig Platz, änderst du den Installationsort mit OllamaSetup.exe /DIR="d:\some\location" und den Speicherort der Modelle mit der Umgebungsvariablen OLLAMA_MODELS (Abschnitt 9). Nach der Installation läuft Ollama im Hintergrund, und der Befehl ollama funktioniert in cmd ebenso wie in der PowerShell.
macOS
Für die manuelle Installation öffnest du Ollama.dmg und ziehst die App in den Ordner „Programme“. Beim ersten Start fragt die App um Erlaubnis, einen Link in /usr/local/bin anzulegen, falls der Befehl ollama nicht im PATH ist (offizielle macOS-Seite).
Linux
Die manuelle Installation ohne Skript und das Zusatzpaket für AMD-GPUs beschreibt die offizielle Linux-Seite. Unter Linux gibt es keine App wie unter Windows und macOS; du nutzt Ollama über Befehle und die API.
Docker
Das offizielle Image ollama/ollama liegt auf Docker Hub. So sieht der minimale Start nur mit CPU aus. Für NVIDIA-GPUs installierst du das NVIDIA Container Toolkit und ergänzt --gpus=all, für AMD-GPUs nimmst du das Image ollama/ollama:rocm (offizielle Docker-Seite). Docker Desktop unter macOS kann die GPU nicht nutzen (offizielle FAQ) – auf dem Mac ist die direkt installierte App schneller.
docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama
docker exec -it ollama ollama run gemma4:e2b
🔌 Funktionstest und Updates: Öffne nach der Installation ein neues Terminal und tippe ollama -v. Erscheint eine Versionsnummer, passt alles. Tippst du ollama ohne Argumente, öffnet sich ein Menü, in dem du ein Modell startest oder eine Integration wie Claude Code anbindest. Updates werden unter Windows und macOS automatisch heruntergeladen; zum Anwenden klickst du auf das Symbol in der Taskleiste bzw. Menüleiste und wählst „Restart to update“. Unter Linux führst du die Installationszeile erneut aus (offizielle FAQ).
3. Läuft es schnell auf deiner GPU? (unterstützte GPUs im Überblick)
Kann Ollama deine GPU nicht nutzen, weicht es auf die CPU aus. Du siehst also keinen Fehler, aber es wird um ein Vielfaches langsamer. Prüfe vor der Installation, ob deine GPU auf der offiziellen Seite Hardware support steht. Hier das Wichtigste.
| GPU / Plattform | Bedingungen für den GPU-Betrieb | Wenn deine nicht aufgeführt ist |
|---|---|---|
| ✓ NVIDIA | Compute Capability 5.0 oder höher (ab GTX 750), Treiber 550 oder neuer (für die Generationen 5.0–6.2 mindestens 570), unter Windows Treiber 551.61 oder neuer | Ältere Karten unterstützen die offiziellen Builds nicht (wie man für ältere GPUs selbst kompiliert, steht in der offiziellen Entwicklerdokumentation) |
| ✓ AMD Radeon (Linux) | ROCm-v7-Treiber, Serien RX 9070 und 9060, RX-7000-Serie, RX 6800 bis 6950 XT, Ryzen AI Max und weitere | Über Vulkan betreiben oder mit HSA_OVERRIDE_GFX_VERSION als nahe verwandte Generation ausführen |
| △ AMD Radeon (Windows) | ROCm v7 / HIP7 unterstützt RX 7600 bis 7900 XTX und die Radeon-PRO-W7000-Serie | Die RX-6000-Serie und andere laufen unter Umständen über Vulkan (standardmäßig aktiv) |
| △ Intel und andere GPUs | Läuft über Vulkan (unter Windows in den meisten Treibern enthalten, unter Linux oft mit Zusatzkomponenten) | Bei Instabilität Vulkan mit OLLAMA_VULKAN=0 abschalten |
| ✓ Mac (Apple-M-Serie) | Nutzt die GPU über Metal, der gemeinsame Arbeitsspeicher dient als VRAM | — |
| ✕ Mac (Intel), Docker unter macOS | Nur CPU | Ein kleineres Modell oder ein Cloud-Modell verwenden |
Ob ein Modell tatsächlich auf der GPU gelandet ist, zeigt ollama ps, während es geladen ist. Steht in der Spalte PROCESSOR 100% GPU, liegt es komplett auf der GPU; eine Aufteilung wie 48%/52% CPU/GPU bedeutet, dass es nicht in den VRAM gepasst hat (offizielle FAQ). Was du bei einer Aufteilung zurückdrehst, steht in der Tabelle in Abschnitt 9. VRAM-Richtwerte pro GPU findest du im Artikel zu den Hardware-Anforderungen.
4. Ollama-Befehle im Überblick
Diese Tabelle enthält die Befehle aus der offiziellen CLI-Referenz und die im Quellcode (cmd/cmd.go) definierten. Im Alltag brauchst du vor allem die ersten sechs.
| Befehl | Was er tut | Beispiel |
|---|---|---|
ollama |
Öffnet ein Menü, in dem du ein Modell startest oder eine Integration anbindest | ollama |
ollama run MODEL [PROMPT] |
Startet ein Modell und chattet damit (lädt es bei Bedarf vorher herunter; mit einem PROMPT antwortet es einmal und beendet sich) | ollama run gemma4 |
ollama pull MODEL |
Lädt ein Modell nur herunter | ollama pull gemma4:e2b |
ollama list |
Listet heruntergeladene Modelle samt Größe auf (Alias: ls) | ollama ls |
ollama ps |
Listet die gerade geladenen Modelle (die Spalte PROCESSOR zeigt GPU oder CPU, die Spalte CONTEXT die genutzte Kontextlänge) | ollama ps |
ollama launch [Integration] |
Startet Claude Code, Codex, OpenCode und andere direkt verbunden mit Ollama-Modellen (--model wählt das Modell, --config konfiguriert nur) |
ollama launch claude |
ollama stop MODEL |
Entlädt ein laufendes Modell aus dem Speicher | ollama stop gemma4 |
ollama rm MODEL |
Löscht ein Modell und gibt Speicherplatz frei (mehrere möglich) | ollama rm gemma4:e2b |
ollama show MODEL |
Zeigt Modellinformationen (--modelfile, --parameters und --license zeigen Einstellungen und Lizenz) | ollama show --modelfile gemma4 |
ollama create MODEL |
Erstellt aus einem Modelfile ein eigenes Modell | ollama create my-assistant -f Modelfile |
ollama cp SOURCE DESTINATION |
Kopiert ein Modell unter neuem Namen | ollama cp gemma4 my-gemma |
ollama push MODEL |
Lädt dein Modell in eine Registry (ollama.com) hoch | ollama push dein-name/my-assistant |
ollama serve |
Startet den API-Server (Alias: start; unter Windows und macOS übernimmt das die Hintergrund-App) | ollama serve |
ollama signin / signout |
An- und Abmeldung bei ollama.com (für Cloud-Modelle) | ollama signin |
ollama run hat einige praktische Optionen. Mit --verbose erscheinen nach jeder Antwort die Laufzeit und die Tokens pro Sekunde (eval rate) – so vergleichst du die Geschwindigkeit in Zahlen, wenn du Modell oder Tag wechselst. --think=false unterdrückt bei Modellen, die ihren Denkprozess ausgeben, diesen Prozess, --format json lässt die Antwort als JSON zurückkommen, und --keepalive 30m ändert, wie lange das Modell im Speicher bleibt. Bei Modellen, die Bilder lesen können, schreibst du einfach den Dateipfad in den Prompt, etwa ollama run gemma4 "Was ist auf diesem Bild? ./photo.png".
Im Chat (nach der Eingabeaufforderung >>>) gibt es eigene Befehle, die mit / beginnen. /bye beendet den Chat, /? listet alle auf, /clear löscht den Gesprächskontext, und /set parameter num_ctx 8192 ändert die Kontextlänge sofort. Mehrere Zeilen auf einmal gibst du ein, indem du sie in """ einschließt.
5. Modelle laden und Tags lesen
Ein Modell wird über Name + Tag angegeben. Lässt du den Tag weg, wird latest verwendet – aber auf welche Größe latest zeigt, unterscheidet sich von Modell zu Modell. Installierst du ohne nachzusehen, landet womöglich eine viel größere Version auf der Platte als gedacht. Am Beispiel der offiziellen Tag-Liste von gemma4 zeigt die Tabelle, wie man Tags liest (Anzeige vom 12. November 2026).
| Tag | Bedeutung | Größe bei gemma4 |
|---|---|---|
gemma4 (= :latest) |
Die Version ohne Tag, bei gemma4 identisch mit e4b | 6,6–9,5 GB |
:e2b :e4b :12b :26b :31b |
Versionen mit unterschiedlicher Parameterzahl (grundsätzlich: größere Zahl = klüger und schwerer) | 4,6–7,5 GB / 6,6–9,5 GB / 7,7–8,0 GB / 16–19 GB / 19–20 GB |
-q4_K_M -q8_0 -bf16 |
Quantisierungsstufen (kleinere Zahl = leichter, mit etwas geringerer Genauigkeit) | Bei e4b: 6,6 GB / 9,0 GB / 16 GB |
-qat |
Mit Blick auf die Quantisierung trainiert (weniger Qualitätsverlust bei denselben 4 Bit) | Bei e4b: 6,1 GB |
-mlx -nvfp4 -mxfp8 |
Formate für bestimmte Laufzeitumgebungen (mlx für MLX auf Apple Silicon, nvfp4 und mxfp8 sind Formate mit wenigen Bits für neuere GPUs) | Bei e4b: 9,5 GB / 9,5 GB / 12 GB |
:cloud -cloud |
Läuft auf den Servern von Ollama (es wird nichts heruntergeladen) | Belegt keinen lokalen Speicher |
Die Größen sind als Spanne angegeben, weil ein Tag mehrere Formate enthält und das passende für deinen Rechner gewählt wird. Bei gemma4 latest entspricht die Untergrenze von 6,6 GB e4b-it-q4_K_M und die Obergrenze von 9,5 GB e4b-mlx. Im Zweifel nimmst du einen Tag ohne Zusatz (etwa gemma4:e4b), und Ollama wählt das passende Format für deinen Rechner. Die Quantisierungsformate selbst (wie man Q4_K_M bei GGUF liest usw.) behandelt unser Artikel zu Quantisierungsformaten.
Die VRAM-Angaben sind Richtwerte: Modellgröße plus Reserve für das Gespräch (den Kontext). Auch der offizielle Quickstart empfiehlt für gemma4:e2b (im standardmäßig installierten Format etwa 7,2 GB) „8 GB VRAM (bzw. gemeinsamen Speicher auf dem Mac)“. Nach der Installation zeigt ollama show gemma4 Parameterzahl, Quantisierung und Kontextlänge.
💡 Welches Modell? Die Beispiele oben dienen nur dazu, Tags lesen zu lernen. Welche Modellfamilien für welchen Zweck (allgemein / Programmieren / deine Sprache) am stärksten sind, steht in unserem großen Vergleich der besten lokalen LLM-Modelle; die Modellwahl zum Programmieren im Editor behandelt der Artikel zu Ollama + Cline.
6. Mit einer Oberfläche nutzen (Ollama-App, Open WebUI und mehr)
Kein Fan des Terminals? Dann öffne zuerst die App von Ollama selbst. Die Versionen für Windows und macOS enthalten ein Fenster, in dem du ein Modell auswählst und chattest (offizieller Blogbeitrag „Ollama's new app“). Unter Linux gibt es keine App – nimm dort eine der anderen Oberflächen unten.
Die Ollama-App (Windows, macOS)
Enthält Modellauswahl, Download und Chat. Du kannst Text- oder PDF-Dateien hineinziehen, damit das Modell sie liest, und Bilder an Modelle geben, die Bilder verstehen. Ein Schieberegler in den Einstellungen ändert die Kontextlänge. Unter macOS verbindest du über „Apps“ Ollama-Modelle mit den Desktop-Apps von Claude und ChatGPT.
Die beliebte Oberfläche im ChatGPT-Stil für den Browser, die du mit deinem lokalen Ollama verbindest. Sie unterstützt Chatverlauf, Modellwechsel und mehrere Nutzer – passend, wenn sich ein Haushalt oder ein Team eine Ollama-Installation teilt.
Von Anfang an nur eine GUI? LM Studio
Eine von Ollama getrennte App, die Modellsuche, Download und Chat in einem Fenster abdeckt. Ein guter Einstieg für alle, die nicht programmieren, und auf Apple Silicon kann sie auch Modelle im MLX-Format verarbeiten.
7. Cloud-Modelle und Preise
Wenn deine GPU ein großes Modell nicht schafft, nutzt du mit denselben Abläufen Cloud-Modelle, die auf den Servern von Ollama laufen. Melde dich mit ollama signin bei ollama.com an und gib einen Namen mit :cloud an, etwa ollama run gemma4:cloud. Ein Download ist nicht nötig (offizielle Cloud-Seite). Die Pläne sehen so aus (Preisseite, Stand: 12. November 2026).
| Plan | Monatlich | Enthaltene Nutzung | Gleichzeitige Anfragen |
|---|---|---|---|
| Pay as you go | $0 | Keine (Bezahlung pro Token für das, was du nutzt) | 3 |
| Pro | $20 ($200 bei jährlicher Zahlung) | Jeden Monat Guthaben im Wert von $60 | 3 |
| Max | $100 | Jeden Monat Guthaben im Wert von $300 | 10 |
| Team (Early Access) | $500 | Jeden Monat $1.000, im Team geteilt | 10 |
Die Nutzung wird nach dem Preis des jeweiligen Modells pro Million Tokens abgerechnet. Die Cloud-Version von gemma4 kostet zum Beispiel $0,14 für die Eingabe und $0,40 für die Ausgabe. Für 1 Million Eingabe- und 200.000 Ausgabe-Tokens ergibt das 0,14 + 0,40 × 0,2 = etwa $0,22. In diesem Verhältnis reichen die $60 von Pro für rund 270 solcher Durchgänge im Monat (60 ÷ 0,22). Nicht genutztes Guthaben verfällt zum Monatswechsel. Modelle auf deinem eigenen Rechner sind in jedem Plan unbegrenzt und kostenlos.
🔒 Umgang mit deinen Daten: Laut offizieller FAQ sieht Ollama bei lokaler Nutzung weder deine Prompts noch deine Daten. Bei Cloud-Modellen werden Eingaben und Antworten zwar verarbeitet, aber weder gespeichert noch protokolliert und nie fürs Training genutzt. Laut Preisseite werden die Cloud-Modelle hauptsächlich in den USA gehostet und bei hoher Nachfrage auch nach Europa umgeleitet. Willst du die Cloud komplett ausschließen, setze die Umgebungsvariable OLLAMA_NO_CLOUD=1 oder trage "disable_ollama_cloud": true in ~/.ollama/server.json ein und starte neu. Zeigt das Log Ollama cloud disabled: true, ist es aktiv.
8. Die API nutzen (OpenAI- und Anthropic-kompatibel)
Die eigentliche Stärke von Ollama ist die lokale API. Standardmäßig lauscht der Server auf 127.0.0.1:11434; schickst du Anfragen dorthin, können deine Apps, Skripte und Tools ein lokales LLM nutzen. Es gibt drei Formate.
Ollama-API
POST localhost:11434
/api/chat
/api/generate
Das Ollama-eigene Format. Es nimmt Ollama-spezifische Optionen wie keep_alive und options.num_ctx an.
OpenAI-kompatibel
POST localhost:11434
/v1/chat/completions
/v1/responses
Code für OpenAI weiterverwenden – nur der Endpunkt ändert sich.
Anthropic-kompatibel
POST localhost:11434
/v1/messages
Tools anbinden, die für die API von Anthropic gebaut sind, etwa Claude Code.
/api/chat (den Gesprächsverlauf mitschicken)
curl http://localhost:11434/api/chat -d '{
"model": "gemma4",
"messages": [{
"role": "user",
"content": "Why is the sky blue?"
}],
"stream": false
}'
Die Antwort steht in message.content. Lässt du "stream": false weg, kommt die Antwort Stück für Stück als JSON-Zeilen zurück (Streaming ist der Standard). Für eine einzelne Antwort kannst du auch einen "prompt" an /api/generate schicken. Das Beispiel oben ist für die Shells von macOS und Linux geschrieben; die Windows-PowerShell behandelt Anführungszeichen anders, nimm dort diese Form von der offiziellen Windows-Seite (nur der Modellname ist geändert).
(Invoke-WebRequest -method POST -Body '{"model":"gemma4", "prompt":"Why is the sky blue?", "stream": false}' -uri http://localhost:11434/api/generate ).Content | ConvertFrom-json
OpenAI-kompatibel (/v1)
Mit der offiziellen OpenAI-Bibliothek genügt es, base_url auf Ollama zu richten. Laut der offiziellen Dokumentation ist der API-Schlüssel auf einem lokalen Server „erforderlich, wird aber ignoriert“ – eine beliebige Zeichenfolge reicht also.
from openai import OpenAI
client = OpenAI(
base_url='http://localhost:11434/v1/',
api_key='ollama', # required but ignored
)
chat_completion = client.chat.completions.create(
messages=[{'role': 'user', 'content': 'Say this is a test'}],
model='gemma4',
)
print(chat_completion.choices[0].message.content)
Anthropic-kompatibel (Claude Code anbinden)
Laut der offiziellen Seite zur Anthropic-Kompatibilität setzt du für Tools, die auf die API von Anthropic ausgelegt sind, diese zwei Umgebungsvariablen. Auch ohne sie selbst zu setzen, startet ollama launch claude Claude Code direkt verbunden.
export ANTHROPIC_AUTH_TOKEN=ollama # required but ignored
export ANTHROPIC_BASE_URL=http://localhost:11434
Beide Kompatibilitätsschichten unterstützen nur einen Teil der Original-APIs. Das Responses-Format etwa ist zustandslos, du musst den Gesprächsverlauf also jedes Mal mitschicken. Nutzt du ein lokales Modell mit einem Coding-Agenten, ist die Kontextlänge aus dem nächsten Abschnitt entscheidend.
🔌 Als Ersatz oder Rückfallebene für die Cloud: Viele Bibliotheken und Tools unterstützen die API von OpenAI oder Anthropic. Richtest du sie auf Ollama, nutzt du lokale Modelle statt der Cloud – das eignet sich auch als Ausweichlösung, wenn ein Cloud-Dienst ausfällt. Für Python und JavaScript gibt es außerdem offizielle Bibliotheken (pip install ollama / npm i ollama).
9. Anpassen (Modelfile, Umgebungsvariablen, Speicher-Tuning)
Modelfile: ein eigenes Modell bauen
Ein Modelfile ist eine Konfigurationsdatei ähnlich einem Dockerfile. Du gehst von einem Basismodell aus (FROM, Pflicht), ergänzt Parameter (PARAMETER) und einen System-Prompt (SYSTEM) und erhältst „dein eigenes Modell“, das sich immer gleich verhält. Ein minimales Beispiel:
FROM gemma4
PARAMETER temperature 0.7
PARAMETER num_ctx 16384
SYSTEM """Du bist ein knapper Assistent. Beginne mit dem Wichtigsten und antworte auf Deutsch."""
Speichere das als Datei namens Modelfile und führe im selben Ordner Folgendes aus. Steht num_ctx im Modelfile, verlängerst du die Kontextlänge nur für dieses Modell, ohne den Standard des ganzen Servers zu ändern.
ollama create my-assistant -f Modelfile
ollama run my-assistant
Das Modelfile eines vorhandenen Modells zeigt ollama show --modelfile gemma4. Es zu kopieren und anzupassen ist der schnellste Einstieg.
Wichtige Umgebungsvariablen
Das Verhalten des Servers steuerst du über Umgebungsvariablen. ollama serve --help gibt die vollständige Liste aus. Hier die gängigsten, mit den Standardwerten aus dem Quellcode (envconfig/config.go) und der offiziellen FAQ.
| Variable | Was sie ändert | Standard |
|---|---|---|
OLLAMA_HOST |
Adresse und Port, auf denen der Server lauscht (mit 0.0.0.0:11434 können andere Geräte im LAN ihn nutzen) | 127.0.0.1:11434 |
OLLAMA_MODELS |
Speicherort der Modelle (nützlich, um sie auf ein größeres Laufwerk zu verlegen) | macOS ~/.ollama/models, Windows C:\Users\%username%\.ollama\models, Linux /usr/share/ollama/.ollama/models |
OLLAMA_CONTEXT_LENGTH |
Die Standard-Kontextlänge | Abhängig vom VRAM (unter 24 GiB: 4k / 24–48 GiB: 32k / ab 48 GiB: 256k) |
OLLAMA_KEEP_ALIVE |
Wie lange ein Modell nach der letzten Nutzung im Speicher bleibt (-1 hält es dauerhaft geladen, 0 entlädt es sofort) | 5m (5 Minuten) |
OLLAMA_NUM_PARALLEL |
Wie viele Anfragen ein Modell gleichzeitig bearbeitet | 1 |
OLLAMA_MAX_LOADED_MODELS |
Wie viele Modelle gleichzeitig im Speicher liegen dürfen | 3 × Anzahl der GPUs (3 bei reiner CPU) |
OLLAMA_MAX_QUEUE |
Höchstzahl wartender Anfragen bei Last (darüber antwortet der Server mit 503) | 512 |
OLLAMA_FLASH_ATTENTION |
Erzwingt Flash Attention (1) oder schaltet es ab (0) | Wird automatisch genutzt, wo unterstützt |
OLLAMA_KV_CACHE_TYPE |
Genauigkeit des Speichers, der das Gespräch hält (K/V-Cache); q8_0 braucht etwa die Hälfte, q4_0 etwa ein Viertel | f16 |
OLLAMA_ORIGINS |
Ursprünge, die aus dem Browser zugreifen dürfen (kommagetrennt; für Erweiterungen etwa chrome-extension://*) | 127.0.0.1 und 0.0.0.0 |
OLLAMA_NO_CLOUD |
Mit 1 werden Cloud-Funktionen (Remote-Inferenz und Websuche) abgeschaltet – nur noch lokal | Aus |
Wie du sie setzt, hängt vom Betriebssystem ab (offizielle FAQ). Unter Windows beendest du Ollama über die Taskleiste, legst in den Einstellungen für Umgebungsvariablen eine Benutzervariable an und startest Ollama über das Startmenü neu. Unter macOS setzt du sie etwa mit launchctl setenv OLLAMA_HOST "0.0.0.0:11434" und startest die App neu. Unter Linux (mit systemd) gehst du so vor:
systemctl edit ollama.service
# unter [Service] je Variable eine Zeile ergänzen
# Environment="OLLAMA_HOST=0.0.0.0:11434"
systemctl daemon-reload
systemctl restart ollama
Tuning bei wenig Speicher oder langem Kontext
Mit weniger als 24 GiB VRAM beträgt die Standard-Kontextlänge nur 4k (etwa 4.000 Tokens). Die offizielle Seite Context length empfiehlt für Websuche, Agenten und Coding-Tools mindestens 64.000 Tokens. Ist der Kontext zu kurz, vergisst das Modell Früheres, ohne einen Fehler anzuzeigen. Die Tabelle nennt deshalb die Einstellung je Ziel, damit du vom Symptom aus rückwärts suchen kannst.
| Was du willst | Einstellung | Was dafür steigt |
|---|---|---|
| Langer Kontext für einen Coding-Agenten | OLLAMA_CONTEXT_LENGTH=64000 ollama serve oder der Schieberegler in den App-Einstellungen |
VRAM-Verbrauch; läuft er über, wandert Arbeit auf die CPU und es wird langsam |
| Längerer Kontext, der trotzdem in den VRAM passt | OLLAMA_KV_CACHE_TYPE=q8_0 (K/V-Cache etwa halb so groß wie bei f16) |
Leichter Genauigkeitsverlust, bei q4_0 deutlicher spürbar bei langem Kontext |
| Mehrere Personen oder Tools gleichzeitig bedienen | OLLAMA_NUM_PARALLEL=4 |
Benötigter Speicher wächst auf parallele Anfragen × Kontextlänge (2k bei 4 parallel braucht 8k) |
| Kein Warten mehr auf das Laden des Modells | OLLAMA_KEEP_ALIVE=-1 |
VRAM bleibt auch im Leerlauf belegt (entladen mit ollama stop) |
| PROCESSOR ist auf CPU/GPU aufgeteilt und langsam | Ein kleinerer Tag (z. B. :12b→:e4b) oder eine kürzere Kontextlänge |
Antwortqualität oder wie viel das Modell behalten kann |
Prüfe nach einer Änderung mit ollama ps, dass die Spalte CONTEXT die gewünschte Länge zeigt und PROCESSOR weiter 100% GPU meldet. Wie sich die Kontextlänge in Speicher umrechnet, steht im Artikel zu den Hardware-Anforderungen; die Symptome eines Agenten, dem der Kontext ausgeht, beschreibt der Artikel zu Ollama + Cline.
10. Fehlerbehebung
Häufige Stolpersteine und die Lösungen aus der offiziellen FAQ und der Seite Troubleshooting.
Langsam oder stockend
Zeigt die Spalte PROCESSOR in ollama ps nicht 100% GPU, passt das Modell nicht in den VRAM. Geh eine Tag-Größe runter oder verkürze den Kontext und vergleiche die Geschwindigkeit mit --verbose.
GPU nach dem Ruhezustand nicht mehr genutzt (Linux)
Ein Fehler im NVIDIA-Treiber kann Ollama auf die CPU zurückfallen lassen. Die Abhilfe auf der offiziellen Seite Hardware support ist, den Treiber mit sudo rmmod nvidia_uvm && sudo modprobe nvidia_uvm neu zu laden.
API verbindet nicht oder liefert 503
Prüfe, ob der Server (die App oder ollama serve) läuft und ob nichts anderes Port 11434 belegt. Für den Zugriff von einem anderen Rechner setzt du OLLAMA_HOST auf 0.0.0.0. Ein 503 heißt, dass die Warteschlange übergelaufen ist – prüfe OLLAMA_MAX_QUEUE.
Downloads scheitern im Firmennetz
Gib den Proxy mit HTTPS_PROXY an. Die offizielle Dokumentation warnt davor, HTTP_PROXY zu setzen (Modelle werden nur per HTTPS geladen, und es kann Client-Verbindungen stören).
Wo die Logs liegen
Unter Windows in server.log unter %LOCALAPPDATA%\Ollama, unter macOS in ~/.ollama/logs/server.log, unter Linux über journalctl -u ollama, in Docker über docker logs.
Nicht mehr beim Anmelden starten
Unter Windows deaktivierst du ollama im Task-Manager unter „Autostart-Apps“, unter macOS schaltest du Ollama in den Einstellungen unter „Anmeldeobjekte“ ab. Die Einstellung bleibt auch nach Updates erhalten.
Fazit
Ollama führt offene Modelle auf deinem eigenen Rechner oder in der Cloud mit denselben Abläufen aus. Vier Punkte zum Mitnehmen:
- Vor der Installation die GPU prüfen: NVIDIA braucht Compute Capability 5.0 oder höher, AMD die ROCm-v7-Liste oder Vulkan, Macs einen Apple-M-Chip. Läuft es, kontrolliere in
ollama ps, ob100% GPUdasteht. - Erst den Tag lesen, dann wählen: Was
latestenthält, unterscheidet sich je Modell. Achte auf die Größenangabe (e2b, 12b, 31b) und nimm im Zweifel einen Tag ohne Zusatz. - Die Kontextlänge selbst festlegen: Unter 24 GiB VRAM liegt der Standard bei 4k. Für Agenten werden mindestens 64k empfohlen; Speicher gewinnst du durch Quantisierung des K/V-Caches zurück.
- Tools über API und launch anbinden: Die OpenAI- und Anthropic-kompatiblen APIs und
ollama launchmachen es für eigene Apps und Claude Code nutzbar. Schwere Modelle laufen mit:cloud.
Öffne als Erstes die App oder tippe ollama run gemma4:e2b. Am besten lernst du es, indem du es laufen lässt und dabei die Unterschiede zur Cloud und die Modellauswahl nachvollziehst. Willst du ein Modell in deinen Editor einbinden, damit es Code schreibt, behandelt Programmieren mit einem lokalen LLM die Einrichtung von Cline und Continue.
FAQ
Q. Ist Ollama kostenlos? Darf ich es kommerziell nutzen?
A. Ollama selbst ist kostenlos und Open Source, und Modelle auf deinem eigenen Rechner kosten nichts, egal wie viel du sie nutzt. Allerdings hat jedes Modell, das du ausführst, seine eigene Lizenz, und ob die kommerzielle Nutzung erlaubt ist, hängt vom Modell ab (prüfbar mit ollama show --license modellname; Details im Lizenzabschnitt unseres Modellvergleichs). Für Cloud-Modelle fallen die Kosten aus Abschnitt 7 an.
Q. Ollama oder LM Studio – was ist besser?
A. Für Befehle, APIs, Automatisierung und die Anbindung von Coding-Agenten Ollama; wer von der Modellsuche bis zum Chat alles in einer Oberfläche erledigen will, LM Studio. Auch Ollama hat eine Chat-App – du kannst also zuerst Ollama installieren und LM Studio ausprobieren, falls dir etwas fehlt.
Q. Werden meine Daten nach außen gesendet?
A. Solange du ein Modell auf deinem eigenen Rechner ausführst, bleibt die Verarbeitung auf deinem PC; die offizielle FAQ stellt klar, dass Ollama bei lokaler Nutzung deine Prompts und Daten nicht sieht. Wählst du ein Modell mit :cloud, wird deine Eingabe auf den Servern von Ollama verarbeitet (laut Ollama weder gespeichert noch fürs Training genutzt). Willst du rein lokal bleiben, setze OLLAMA_NO_CLOUD=1.
Q. Wie aktualisiere oder deinstalliere ich Ollama?
A. Unter Windows und macOS werden Updates automatisch heruntergeladen und über „Restart to update“ im Symbol angewendet. Unter Linux führst du die Installationszeile erneut aus. Zum Deinstallieren entfernst du Ollama unter Windows über die App-Liste in den Einstellungen; unter macOS löschst du die Elemente, die auf der offiziellen macOS-Seite aufgeführt sind. Die Modelle bleiben im Ordner .ollama liegen – lösche ihn ebenfalls, wenn du sie nicht mehr brauchst (und den mit OLLAMA_MODELS gesetzten Ordner, falls du sie verlegt hast).
Q. Kann ich Claude Code oder Codex mit Ollama-Modellen betreiben?
A. Ja. ollama launch claude (bzw. ollama launch codex für Codex) startet sie direkt verbunden mit Ollama-Modellen. Bei lokalen Modellen empfiehlt die offizielle Dokumentation eine Kontextlänge von mindestens 64.000 Tokens.
Q. Was für einen PC brauche ich?
A. Der offizielle Quickstart empfiehlt für das kleinste Modell, gemma4:e2b (im Standardformat etwa 7,2 GB), 8 GB VRAM oder auf dem Mac ähnlich viel gemeinsamen Speicher. Mit weniger VRAM läuft es über den Arbeitsspeicher weiter, aber langsamer. Richtwerte für größere Modelle findest du im Artikel zu den Hardware-Anforderungen. Auf einem PC mit schwacher GPU sind Cloud-Modelle eine Alternative.