Desplegar Paperclip en un VPS con ServerAvatar: guía 2026
En pocas palabras: ServerAvatar despliega Paperclip en tu VPS Ubuntu automatizando el aprovisionamiento, el deploy y el certificado SSL. Necesitás PostgreSQL 17 (lo exige el ORM Drizzle) y HTTPS. Así corrés esta plataforma open-source de agentes IA —con Claude y OpenAI— en tu propio servidor, no en la nube de Paperclip.
Desplegar Paperclip en VPS significa correr esta plataforma open-source de agentes de IA en tu propio servidor Ubuntu, con PostgreSQL 17, HTTPS y autenticación para cada usuario. ServerAvatar automatiza el aprovisionamiento, el deploy y el certificado SSL, así tus datos quedan en tu infraestructura y no en la nube de Paperclip.
Paperclip es una plataforma open-source de gestión de agentes de IA con panel web. Con ella creás agentes, les definís objetivos y conectás proveedores de modelos como Anthropic Claude y OpenAI desde un dashboard. Su código vive en el repositorio de paperclipai en GitHub. La versión hosteada guarda tus datos en la nube de Paperclip; con la self-hosted, quedan en tu servidor.
En 30 segundos
- Paperclip es open-source: plataforma de agentes IA que conecta Claude y OpenAI desde un panel web.
- Self-hosting = tus datos: en la nube quedan en servidores de Paperclip; en tu VPS, en tu propia infraestructura.
- PostgreSQL 17 obligatorio: el ORM Drizzle que usa Paperclip no soporta MySQL ni MariaDB.
- Escucha solo en 127.0.0.1:3100: Apache o Nginx hacen de reverse proxy para el tráfico público.
- ServerAvatar automatiza: aprovisionamiento del server, deploy de la app y SSL con Let’s Encrypt.
¿Qué es Paperclip y por qué conviene auto-hospedarlo?
Auto-hospedar Paperclip te da la propiedad total de los datos de tus agentes. En la versión cloud, todo lo que generan tus agentes (prompts, objetivos, respuestas de los modelos) se guarda en los servidores de Paperclip. Para un equipo con requisitos estrictos de privacidad, eso puede ser un problema. Con self-hosting, esa información no sale de tu VPS.
Un aviso rápido para no confundir: este Paperclip no es la vieja “gema” de Ruby para adjuntar archivos en Rails (quedó deprecada en Rails 5.2 (2018) en favor de Active Storage). Son cosas distintas que comparten nombre. Acá hablamos de la plataforma de agentes de IA que corre sobre Node.js y Postgres.
¿Por qué alguien se tomaría el laburo de montarlo en un servidor propio en vez de usar la nube y listo? Por control. Controlás los backups, los logs, la auditoría y, sobre todo, dónde viven los datos. Te recomendamos nuestro artículo sobre automatización de pipelines de despliegue.
¿Qué requisitos técnicos necesitás para instalar Paperclip en Ubuntu?
Paperclip corre sobre un VPS con Ubuntu 22.04 LTS o superior, Node.js moderno y PostgreSQL 17. No pide una máquina cara: la documentación de despliegue habla de instalaciones limpias sobre un VPS chico. Estos son los puntos que conviene tener resueltos antes de arrancar:
- Sistema operativo: Ubuntu 22.04 LTS o más nuevo (hasta 2032), en un VPS fresco.
- Runtime: Node.js 20+ y pnpm como gestor de paquetes.
- Base de datos: PostgreSQL 17. No hay reemplazo, más abajo te explico por qué.
- Recursos: un VPS chico alcanza; no hace falta una máquina cara para montarlo.
- Red: un dominio apuntando al VPS y los puertos 80 y 443 abiertos (el 3100 queda cerrado al exterior).
¿Qué ventajas te da el self-hosting frente a la nube?
La ventaja concreta del self-hosting es soberanía de datos y control de costos. Si tu empresa tiene que cumplir GDPR o normativas locales, tener los datos de los agentes en tu propia infraestructura te simplifica la vida (y las auditorías). No hay un tercero en el medio guardando lo que hacen tus agentes.
El otro punto es la plata. En modelos cloud solés pagar por cuotas o por agente. Con Paperclip en tu VPS, pagás el servidor y el uso de las APIs de los modelos que conectás, y nada más. Vos decidís cuántos agentes corrés.
¿Por qué Paperclip exige PostgreSQL 17 y no MySQL?
Paperclip necesita PostgreSQL 17 porque su capa de datos usa Drizzle ORM, que en este proyecto no soporta MySQL ni MariaDB. Si intentás montarlo sobre MySQL, no arranca. Es un requisito duro, no una recomendación.
En la práctica, la instalación de Postgres 17 en Ubuntu es directa: instalás el paquete, creás la base de datos y un usuario dedicado con permisos sobre esa base, y le pasás esas credenciales a Paperclip. Nada raro. Eso sí: usá un usuario específico para la app, no el superusuario de Postgres. Lo explicamos a fondo en elegir tu herramienta de CI/CD.
¿Cómo desplegar Paperclip en un VPS con ServerAvatar?
ServerAvatar es un panel de gestión de servidores que se encarga del aprovisionamiento del VPS, el deploy de la aplicación y los certificados SSL. La idea es que no pelees a mano con reglas de firewall ni con registros DNS: el panel hace el trabajo pesado y vos te concentrás en configurar Paperclip.
Según la guía oficial de ServerAvatar, el flujo típico es: conectás tu VPS Ubuntu al panel, desplegás Paperclip detrás de un dominio propio, activás HTTPS y sumás PostgreSQL. Después dejás la autenticación obligatoria para cada usuario que entre al panel. Algunos proveedores incluso ofrecen imágenes one-click con Paperclip preinstalado, lo que te ahorra los primeros pasos.
Si preferís un VPS en Argentina con soporte local para levantar todo esto, podés correrlo sobre un servidor de donweb.com y montar ServerAvatar encima.
¿Cómo configurar HTTPS, dominio y reverse proxy?
Paperclip escucha solo en 127.0.0.1:3100 por seguridad, así que necesitás un reverse proxy que reciba el tráfico público en los puertos 80 y 443. Apache (o Nginx) toma las peticiones, las cifra con SSL y las reenvía al 3100 interno. Nunca exponés el 3100 directo a internet.
Los pasos: registrás el dominio, apuntás el DNS al IP del VPS, generás el certificado con Let’s Encrypt y configurás el ProxyPass y ProxyPassReverse hacia 127.0.0.1:3100. Ojo con un detalle que rompe logins: tenés que pasar los headers x-forwarded-host y x-forwarded-proto, porque si no la autenticación se marea con el dominio real.
¿Cómo asegurar la autenticación y el panel?
El panel de Paperclip debe pedir autenticación a cada usuario, sin excepciones. Eso ya viene contemplado en el despliegue recomendado. A partir de ahí, la seguridad es la de cualquier servicio serio en un VPS: contraseñas fuertes y, si el panel lo permite, un segundo factor. Tema relacionado: configurar correctamente hreflang.
Del lado del sistema, bloqueá el puerto 3100 en el firewall para que solo responda en localhost, entrá por SSH con llaves (nada de contraseña) y corré la app con un usuario no-root. Subís las defensas de a poco, revisás los logs, y listo. Son cinco minutos que te ahorran un dolor de cabeza.
Opciones para desplegar Paperclip: comparativa
| Método | Qué automatiza | Ideal para |
|---|---|---|
| ServerAvatar (panel administrado) | Provisioning, deploy, SSL y firewall desde una UI | Equipos que no quieren pelear con la consola |
| Imagen one-click | Paperclip ya preinstalado en el VPS | Pruebas rápidas y primeros pasos |
| Docker Compose manual | Nada: control total, todo a mano | Quien quiere entender cada pieza y afinarla |
¿Cuál elegir? Depende de cuánto quieras ensuciarte las manos. El panel administrado te lleva de la mano; el Docker Compose manual te da el control fino pero exige que sepas lo que hacés. Herramientas europeas como Virtua.Cloud también documentan cómo alojar agentes de IA en un VPS si querés otra referencia en español.
Errores comunes al instalar Paperclip
- Intentar usar MySQL o MariaDB. Drizzle ORM no las soporta en este proyecto. Es PostgreSQL 17 o nada. Instalá Postgres antes de tocar Paperclip.
- Dejar el puerto 3100 abierto al mundo. Ese puerto es interno. Cerralo en el firewall y dejá que el reverse proxy sea la única puerta de entrada.
- Olvidar los headers x-forwarded. Sin
x-forwarded-hostyx-forwarded-protoen Apache, la autenticación falla y no entendés por qué. (Pasa más seguido de lo que parece.) - Correr todo como root con login por contraseña. Usuario dedicado, SSH con llaves. Punto.
Preguntas Frecuentes
¿Qué es Paperclip?
Paperclip es una plataforma open-source de gestión de agentes de IA con panel web. Te deja crear agentes, asignarles objetivos y conectar proveedores de modelos como Anthropic Claude y OpenAI desde un dashboard. Podés usarla en su nube o auto-hospedarla en tu propio VPS.
¿Es lo mismo que la gema Paperclip de Ruby?
No, son proyectos distintos que comparten nombre. La gema Paperclip de Ruby servía para adjuntar archivos en aplicaciones Rails y quedó deprecada en Rails 5.2 (2018) en favor de Active Storage. Esta Paperclip es una plataforma de agentes de IA sobre Node.js y PostgreSQL.
¿Qué base de datos necesita Paperclip?
Paperclip requiere PostgreSQL 17. Su ORM Drizzle no soporta MySQL ni MariaDB en este proyecto, así que Postgres es obligatorio. Conviene crear una base y un usuario dedicados solo para la app. Complementá con soluciones de inteligencia artificial.
¿Cuánto tarda instalar Paperclip en un VPS?
Una instalación limpia sobre un VPS Ubuntu nuevo lleva pocos minutos, sobre todo si usás una imagen one-click o un panel como ServerAvatar que automatiza el provisioning y el SSL. La parte que más te puede demorar es apuntar el DNS y esperar su propagación.
¿Paperclip self-hosted es gratis?
El software es open-source y auto-hospedarlo no tiene licencia paga. Lo que pagás es el VPS donde corre y el uso de las APIs de los modelos que conectes (Claude, OpenAI). No hay cuotas por agente como en el modelo cloud.
Conclusión
Auto-hospedar Paperclip cambia una cosa central: dónde viven los datos de tus agentes. Los sacás de la nube de un tercero y los ponés en tu VPS, con PostgreSQL 17, HTTPS y autenticación obligatoria. Un panel como ServerAvatar te saca de encima el provisioning, el SSL y el firewall, y vos te quedás con lo importante: configurar los agentes y cuidar el reverse proxy hacia el 3100.
Si manejás datos sensibles o querés control real de costos, self-hosting es el camino. Levantá un VPS Ubuntu, dejá el 3100 cerrado al exterior, no te olvides de los headers x-forwarded y probá primero en un entorno de prueba antes de mandarlo a producción.
