System Requirements
- Windows: 10 22H2 or newer, Home or Pro
- NVIDIA: Driver version 452.39 or newer
- AMD Radeon: Latest drivers from AMD Support
- Storage: At least 4GB for installation, plus space for models
Ollama uses Unicode characters for progress indicators. If you see unknown squares in Windows 10, try changing your terminal font settings.
Installation
Quick Install
Install using PowerShell:Manual Installation
- Download OllamaSetup.exe
- Run the installer
- Ollama will start automatically in the background
Using Ollama
After installation, Ollama runs in the background and theollama command is available in PowerShell, Command Prompt, or your preferred terminal.
Run Your First Model
Check Running Models
View Installed Models
Configuration
File Locations
You can access these locations in File Explorer by pressingWin+R and entering:
| Shortcut | Location | Contents |
|---|---|---|
%LOCALAPPDATA%\Ollama | Logs and updates | server.log, app.log, upgrade.log |
%LOCALAPPDATA%\Programs\Ollama | Binaries | Executable files (added to PATH) |
%HOMEPATH%\.ollama | Models and config | Downloaded models and configuration |
%TEMP% | Temporary files | ollama* directories with temp executables |
Custom Installation Directory
To install Ollama in a custom location:Changing Model Storage Location
If your home directory doesn’t have enough space for models:Open Environment Variables
- Open Settings (Windows 11) or Control Panel (Windows 10)
- Search for “environment variables”
- Click “Edit environment variables for your account”
Set OLLAMA_MODELS
- Click New or select existing
OLLAMA_MODELSvariable - Set the value to your desired path (e.g.,
D:\OllamaModels) - Click OK to save
Environment Variables
Set environment variables through Windows Settings:Open Environment Variables
- Open Settings (Windows 11) or Control Panel (Windows 10)
- Search for “environment variables”
- Click “Edit environment variables for your account”
Add/Edit Variables
Create or modify variables like:
OLLAMA_HOSTOLLAMA_MODELSOLLAMA_DEBUG
Common Environment Variables
| Variable | Description | Default |
|---|---|---|
OLLAMA_HOST | Server bind address | 127.0.0.1:11434 |
OLLAMA_MODELS | Model storage location | %HOMEPATH%\.ollama\models |
OLLAMA_DEBUG | Enable debug logging | 0 |
OLLAMA_NUM_PARALLEL | Max parallel requests | 1 |
OLLAMA_KEEP_ALIVE | Model keep-alive duration | 5m |
GPU Support
NVIDIA GPUs
Ollama automatically detects NVIDIA GPUs with compatible drivers:- Required: Driver version 452.39 or newer
- Supported: Compute capability 5.0+ (GTX 750 Ti and newer)
AMD Radeon GPUs
Ollama supports AMD Radeon GPUs via ROCm:- Required: Latest Radeon drivers
- Download: AMD Support Site
- Radeon RX 7000 series
- Radeon RX 6000 series
- Radeon PRO W7000/W6000 series
Standalone CLI
For advanced use cases like running Ollama as a Windows service:Download Standalone ZIP
- Download
ollama-windows-amd64.zipfrom releases - Extract to your desired location
- For AMD GPUs, also download and extract
ollama-windows-amd64-rocm.zipto the same directory
Run as a Service
Use NSSM to run Ollama as a Windows service:API Access
Ollama’s REST API is available athttp://localhost:11434:
Updates
Ollama automatically downloads updates:- Click the Ollama icon in the system tray
- When an update is available, select “Restart to update”
Disable Auto-Start on Login
To prevent Ollama from starting automatically:- Open Task Manager (
Ctrl+Shift+Esc) - Go to the Startup apps tab
- Find Ollama and click Disable
Logs and Debugging
View Logs
Access logs through File Explorer:server.log- Most recent server logsapp.log- GUI application logsupgrade.log- Update logs
Enable Debug Logging
In PowerShell:View Logs in PowerShell
Troubleshooting
Ollama Not Starting
-
Check if Ollama is running:
- Check the system tray for the Ollama icon
-
Review logs:
GPU Not Detected
For NVIDIA:-
Verify driver version:
- Ensure driver is 452.39 or newer
- Restart your computer
- Update to the latest Radeon drivers
- Verify GPU is supported
- Check if ROCm libraries were extracted correctly
Port Already in Use
If port 11434 is already in use:-
Set a different port:
- Restart Ollama
Terminal Display Issues (Windows 10)
Older Windows 10 versions (like 21H1) have a bug where control characters display incorrectly:- Symptom: Long strings of characters like
←[?25h←[?25l - Error: “The parameter is incorrect”
- Solution: Update to Windows 10 22H1 or newer
Insufficient Storage
Models can be tens to hundreds of GB:-
Check available space:
- Change model location using environment variables
Uninstallation
- Open Settings
- Go to Apps → Installed apps
- Find Ollama and click Uninstall
If you’ve changed the
OLLAMA_MODELS location, the uninstaller will not remove downloaded models.Next Steps
Quickstart Guide
Get started with your first model
GPU Configuration
Optimize GPU settings and performance
API Reference
Integrate Ollama into your applications
Model Library
Browse available models