Ollama shows a version mismatch error:

Error: model requires Ollama version 0.3.0 or higher

Or models fail after an update. Here is how to fix it.

Fix 1: Update Ollama

Most version issues are fixed by updating:

# Check current version
ollama --version

# Update on Linux
curl -fsSL https://ollama.com/install.sh | sh

# Update on macOS
brew upgrade ollama

# Update on Windows
# Download latest from ollama.com

Fix 2: Re-download models after update

Models may need re-downloading after an update:

# List models with versions
ollama list

# Re-pull if version mismatch
ollama rm llama3.2:latest
ollama pull llama3.2:latest

Fix 3: Check model compatibility

Some models require specific Ollama versions:

# Check model requirements
ollama show llama3.2:latest

# If it shows version requirement, update Ollama

Fix 4: Downgrade Ollama

If the latest version has bugs:

# Linux: Install specific version
wget https://github.com/ollama/ollama/releases/download/v0.3.0/ollama-linux-amd64
chmod +x ollama-linux-amd64
sudo mv ollama-linux-amd64 /usr/local/bin/ollama

# macOS: Use brew to install specific version
brew install ollama@0.3.0

Fix 5: Clear Ollama cache

Corrupted cache after update:

# Stop Ollama
pkill ollama

# Clear cache
rm -rf ~/.cache/ollama

# Restart
ollama serve

Fix 6: Check API compatibility

If using the API, ensure client matches server version:

# Check API version
curl http://localhost:11434/api/version

# Update client libraries
pip install --upgrade ollama
npm update ollama

Still not working?

1. Check release notes — What changed in the version
2. File an issue — GitHub issues for bug reports
3. Use Docker — Pin to specific version: ollama/ollama:0.3.0
4. Wait for fix — Version issues are often fixed quickly

FAQ

Why do I get version mismatch errors?

Ollama updates model formats occasionally. If you updated Ollama but your models were pulled with an older version, they may need re-downloading. Run ollama rm MODEL && ollama pull MODEL to fix.

Should I always update Ollama?

Generally yes, but if you have a working setup, test the update first. Some updates change model formats or behavior. Check release notes before updating in production.

Can I run different Ollama versions on different machines?

Yes. Ollama does not require version consistency across machines. Each installation can run a different version independently.

Related: Ollama Complete Guide · Ollama Model Not Found Fix · Ollama Connection Refused Fix · Ollama Slow Inference Fix