Dep. Comercial +40 365-882.777 +40 722-241.273 Lun-Vin: 10:00-18:00
View Categories

Cum instalez HuggingChat (Chat UI) pe un VPS cu Docker?

1 minut de citit

Cea mai simplă cale de a rula HuggingChat este imaginea Docker chat-ui-db, care include și MongoDB în același container. Îți recomandăm să îl rulezi pe un VPS (de exemplu un plan VPS HostX cu Ubuntu/Debian).

De ce ai nevoie

  • Un VPS cu acces root prin SSH (la HostX, portul 5334).
  • Docker instalat.
  • Un endpoint de model compatibil OpenAI (local prin Ollama sau un serviciu extern) și cheia aferentă.

1. Instalează Docker

curl -fsSL https://get.docker.com | sh

2. Pornește HuggingChat (cu MongoDB inclus)

docker run -d --name chat-ui \
  -p 127.0.0.1:3000:3000 \
  -e OPENAI_BASE_URL=http://host.docker.internal:11434/v1 \
  -e OPENAI_API_KEY=ollama \
  -v chat-ui-data:/data \
  ghcr.io/huggingface/chat-ui-db:latest

Aplicația ascultă pe portul 3000. În exemplu, o conectăm la un server Ollama local prin endpointul compatibil OpenAI.

3. Adaugă HTTPS cu reverse proxy

Pune Nginx sau Caddy în față, pe portul 443, redirecționând către 127.0.0.1:3000. Obține un certificat gratuit prin Let’s Encrypt și verifică-l cu testerul SSL HostX. Nu expune portul 3000 direct pe Internet.

4. Prima accesare

Deschide adresa în browser. Ar trebui să poți începe o conversație cu modelul configurat.

Notă: Imaginea chat-ui-db este cea mai simplă (MongoDB inclus). Pentru producție sau echipe, poți folosi o bază de date MongoDB externă (vezi ghidul dedicat). Datele se salvează în volumul chat-ui-data — fă-i backup.

Actualizat la 06/08/2026