Variabilele OLLAMA_HOST și OLLAMA_MODELS în Ollama CLI & Ghid Local

Server, Rețea și Hardware Ollama 0.40 (octombrie 2026)

Schimbă adresa pe care ascultă serverul Ollama și directorul în care sunt salvate modelele.

Sintaxă & invocare
OLLAMA_HOST=0.0.0.0:11434
OLLAMA_MODELS=/cale/catre/modele

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.

Comenzi înrudite