---
title: Cum instalez MaxKB pe un VPS cu Docker?
description: "MaxKB se instalează rapid printr-o singură comandă **Docker**. Îț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…"
url: "https://www.hostx.ro/kb/cum-instalez-maxkb-pe-un-vps-cu-docker/"
updated: "2026-08-06"
category: "AI & Automatizări / MaxKB"
tags:
  - instalare
  - "Let's Encrypt"
  - Linux
  - MaxKB
  - securitate
  - SSH
  - SSL
  - VPS
---

# Cum instalez MaxKB pe un VPS cu Docker?

MaxKB se instalează rapid printr-o singură comandă **Docker**. Îț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

## 1. Instalează Docker

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

## 2. Pornește MaxKB

```
docker run -d --name=maxkb --restart=always \
  -p 127.0.0.1:8080:8080 \
  -v ~/.maxkb:/var/lib/postgresql/data \
  -v ~/.python-packages:/opt/maxkb/app/sandbox/python-packages \
  1panel/maxkb
```

Aplicația ascultă pe portul **8080**; în exemplu îl mapăm la interfața locală.

## 3. Adaugă HTTPS cu reverse proxy

Pune Nginx sau Caddy în față, pe portul 443, redirecționând către `127.0.0.1:8080`. 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 8080 direct pe Internet.

## 4. Prima autentificare

Accesează adresa serverului și autentifică-te cu datele de administrator implicite afișate în documentație. **Schimbă imediat parola implicită** după prima autentificare.

**Notă:** Datele (baza PostgreSQL încorporată, documentele, vectorii) se salvează în folderul `~/.maxkb`. Fă-i backup periodic.
