---
title: Cum instalez HuggingChat (Chat UI) pe un VPS cu Docker?
description: "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…"
url: "https://www.hostx.ro/kb/cum-instalez-huggingchat-chat-ui-pe-un-vps-cu-docker/"
updated: "2026-08-06"
category: "AI & Automatizări / HuggingChat"
tags:
  - HuggingChat
  - instalare
  - "Let's Encrypt"
  - Nginx
  - SSH
  - SSL
  - VPS
---

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

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](https://www.hostx.ro/testare-ssl). 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.
