Ce face Variabilele OLLAMA_HOST și OLLAMA_MODELS
Ollama ascultă implicit pe 127.0.0.1, portul 11434. Cu OLLAMA_HOST schimbi adresa, de exemplu 0.0.0.0:11434 ca serverul să fie accesibil din rețea. Aceeași variabilă îi spune clientului CLI la ce server să se conecteze.
Modelele se salvează implicit în ~/.ollama/models (macOS), /usr/share/ollama/.ollama/models (Linux) și C:\Users\%username%\.ollama\models (Windows). OLLAMA_MODELS mută directorul. Pe Linux, cu instalarea standard, utilizatorul ollama are nevoie de drepturi de citire și scriere pe directorul nou.
Variabilele se setează pe procesul serverului: launchctl setenv plus repornirea aplicației pe macOS, systemctl edit ollama.service pe Linux, variabilele contului pe Windows. Pentru acces din browser sau extensii mai ai nevoie de OLLAMA_ORIGINS.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
OLLAMA_HOST |
Adresa și portul serverului (implicit 127.0.0.1:11434). |
OLLAMA_MODELS |
Directorul modelelor. |
OLLAMA_ORIGINS |
Origini suplimentare permise pentru cereri cross-origin (implicit doar 127.0.0.1 și 0.0.0.0). |
Exemple practice
Exemplul 1: Linux (systemd)
sudo systemctl edit ollama.service
# în secțiunea [Service]:
Environment="OLLAMA_HOST=0.0.0.0:11434"
Environment="OLLAMA_MODELS=/mnt/date/ollama"
sudo systemctl daemon-reload
sudo systemctl restart ollama
Exemplul 2: Drepturi pe directorul nou (Linux)
sudo chown -R ollama:ollama /mnt/date/ollama
Exemplul 3: macOS (aplicația)
După comandă repornești aplicația Ollama.
launchctl setenv OLLAMA_HOST "0.0.0.0:11434"
Exemplul 4: Proxy Nginx în fața serverului
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://localhost:11434;
proxy_set_header Host localhost:11434;
}
}
Greșeli frecvente și bune practici
- Expui serverul în rețea fără protecție. API-ul local nu cere autentificare.
- Setezi variabilele în shell-ul curent, iar aplicația sau serviciul nu le vede. Repornește serverul după ce le setezi în locul potrivit.
- Muți modelele pe Linux și uiți de drepturile utilizatorului
ollama.