Ollama¶
What it is¶
Ollama allows you to get up and running with large language models locally. It provides a simple CLI and API for running models like Llama 3, Mistral, and others on your own hardware.
What problem it solves¶
It simplifies the complex setup usually required for running LLMs, handling model weights, configurations, and hardware acceleration (GPU) automatically. It enables private, offline AI interactions without relying on cloud providers.
Where it fits in the stack¶
Local Inference Engine. It acts as the execution layer for models on your own hardware, serving as a backend for various WebUIs and agents.
Typical use cases¶
- Private Chat: Interacting with LLMs without data leaving your local network.
- Development & Testing: Locally testing AI-integrated applications before deploying to cloud providers.
- Autonomous Agents: Serving as the local backend for agents like Aider or OpenHands.
- Enterprise Prototyping: Rapidly deploying specialized models for internal document analysis or coding assistance.
Strengths¶
- Ease of Use: One-line installation and simple model pulling (e.g.,
ollama run llama3). - Hardware Acceleration: Automatic detection and utilization of NVIDIA, AMD, and Apple Silicon GPUs.
- Large Model Library: Easy access to Llama 3, Mistral, Phi-3, and many more.
- Zero Cost: No per-token pricing; limited only by your hardware.
Limitations¶
- Hardware Dependent: Performance is strictly tied to local CPU/GPU/RAM.
- Memory Requirements: Larger models require significant VRAM.
When to use it¶
- For maximum privacy and data sovereignty.
- To eliminate per-token costs during development.
- When working in offline or low-connectivity environments.
When not to use it¶
- If you lack dedicated GPU hardware and require low-latency responses.
- For massive models (e.g., 70B+) that exceed consumer hardware capacity.
Licensing and cost¶
- Open Source: Yes (MIT License)
- Cost: Free
- Self-hostable: Yes
Getting started¶
Installation (Docker)¶
services:
ollama:
volumes:
- ./ollama:/root/.ollama
container_name: ollama
pull_policy: always
tty: true
restart: unless-stopped
image: ollama/ollama:latest # v0.24+ (May 2026)
Codex App & Tools¶
Ollama v0.24 (May 2026) introduced the Codex App, a native desktop experience for managing local AI workflows.
- Launch: Use ollama launch codex-app from the terminal.
- Features: Includes built-in browser support for loading local servers/sites directly within the AI interface.
Recommended Models (2026)¶
Avoid relying on the :latest tag, which often points to smaller default versions. For May 2026, the following models are recommended for various hardware profiles:
| Category | Model | VRAM Required | Note |
|---|---|---|---|
| All-Rounder | qwen3:30b |
~24GB | Best balance of speed and intelligence. |
| Reasoning | gemma4:26b |
~20GB | Superior logic and thinking capabilities. |
| 8GB RAM | gemma4:2b |
~1.6GB | Minimal RAM requirements, works on older hardware. |
API Usage Example¶
You can interact with the Ollama API using curl:
curl http://localhost:11434/api/generate -d '{
"model": "llama3",
"prompt": "Why is the sky blue?"
}'
TrueNAS SCALE & GPU Setup¶
Running Ollama on TrueNAS SCALE requires configuring GPU passthrough for optimal performance.
GPU Passthrough (NVIDIA)¶
- Host Configuration: Ensure the NVIDIA driver is active in TrueNAS SCALE (System Settings > Advanced > Isolated GPU Device).
- Docker/App Configuration: In the application settings, allocate
1(or more) GPU under the "Resource Reservation" section. - Environment: Ensure
NVIDIA_VISIBLE_DEVICES=allandNVIDIA_DRIVER_CAPABILITIES=compute,utilityare set in the container environment.
Performance Benchmarking¶
Tokens per second (t/s) vary by model size and hardware. Use ollama run <model> and then /set verbose to see generation statistics.
| Hardware | Model | VRAM Used | Eval Rate (t/s) |
|---|---|---|---|
| Intel i7 (12th Gen) | Llama 3.1 8B | 0GB (CPU) | ~3-5 t/s |
| NVIDIA RTX 3060 (12GB) | Llama 3.1 8B | ~5.5GB | ~45-55 t/s |
| NVIDIA RTX 4090 (24GB) | Llama 3.1 8B | ~5.5GB | ~130+ t/s |
| NVIDIA RTX 4090 (24GB) | Llama 3.1 70B | ~42GB (Quant) | ~15-20 t/s |
Related tools / concepts¶
- Open WebUI — The recommended web frontend for Ollama.
- LiteLLM — For load balancing multiple Ollama instances.
- Local LLMs — Overview of the local model ecosystem.
- LM Studio — A desktop-first alternative for model experimentation.
Backlog¶
- [x] Perform quarterly technical freshness audit (May 2026).
Sources / References¶
Contribution Metadata¶
- Last reviewed: 2026-05-26
- Confidence: high