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.