---
title: Cum instalez Paperclip pe un VPS
description: "**Paperclip** este self-hostable și rulează bine pe un **VPS** (de exemplu un plan VPS HostX cu Linux). Fiind o aplicație **Node.js** cu PostgreSQL încorporat, instalarea de bază este simplă. ## De ce ai nevoie - Un VPS cu acces root…"
url: "https://www.hostx.ro/kb/cum-instalez-paperclip-pe-un-vps/"
updated: "2026-08-04"
category: "AI & Automatizări / Paperclip"
tags:
  - API
  - configurare server
  - firewall
  - instalare
  - Linux
  - Node.js
  - PaperClip
  - PostgreSQL
  - SSH
  - terminal
  - VPS
---

# Cum instalez Paperclip pe un VPS

**Paperclip** este self-hostable și rulează bine pe un **VPS** (de exemplu un plan VPS HostX cu Linux). Fiind o aplicație **Node.js** cu PostgreSQL încorporat, instalarea de bază este simplă.

## De ce ai nevoie

- Un VPS cu acces root prin SSH (la HostX, portul **5334**).
- **Node.js** (versiune recentă).
- Chei API pentru cel puțin un furnizor AI (de exemplu Anthropic, OpenAI sau Google).

## 1. Instalează Node.js

```
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt-get install -y nodejs
```

## 2. Instalează și pornește Paperclip

**Paperclip** se poate rula printr-o singură comandă (npx), care configurează automat baza PostgreSQL încorporată și datele locale:

```
npx paperclip
```

Alternativ, îl poți clona din repository-ul oficial și porni conform instrucțiunilor din README. La prima pornire, aplicația inițializează baza de date și tabloul de bord.

## 3. Accesează tabloul de bord

Deschide interfața web la adresa indicată în terminal (implicit pe un port local). De aici pornește **Onboarding Wizard**-ul, care te ghidează la crearea primei companii și a primului agent.

## 4. Rulare permanentă și securizare

Pentru producție, rulează **Paperclip** cu un process manager (de exemplu PM2) și pune-l în spatele unui reverse proxy cu HTTPS. Nu expune portul direct în internet.

**Notă:** Datele (companii, agenți, jurnal de audit) sunt în PostgreSQL. Salvează periodic  backup-ul bazei de date. Pentru volume mari, poți folosi o instanță PostgreSQL dedicată în locul celei încorporate.