Instalación en 15 minutos

Instalar Papyro

Esta guía explica cómo instalar Papyro en tu propio servidor. Se asumen conocimientos básicos de Docker.

1. Requisitos

Docker 24+ y docker compose v2
Mínimo 2 GB de RAM, 10 GB de disco
Proxy inverso con HTTPS (Cloudflare, Traefik, nginx)
Un dominio o subdominio (p. ej. papyro.yourcompany.com)
Tu LICENSE_KEY adquirida (enviada por correo)
Tu token de GHCR (para descargar la imagen, enviado por correo)

2. Preparar el directorio de trabajo

mkdir papyro && cd papyro
curl -fsSL https://papyro.dev/install/docker-compose.yml -o docker-compose.yml
curl -fsSL https://papyro.dev/install/env.example -o .env

3. Rellenar el archivo .env

Pega los valores del correo de tu compra:

# Domain
BETTER_AUTH_URL=https://papyro.yourcompany.com

# Database password (generate randomly)
DB_PASSWORD=$(openssl rand -hex 16)

# Better Auth secret (generate randomly)
BETTER_AUTH_SECRET=$(openssl rand -hex 32)

# Redis password (generate randomly)
REDIS_PASSWORD=$(openssl rand -hex 16)

# Cron secret (generate randomly)
CRON_SECRET=$(openssl rand -hex 32)

# License (from your purchase email)
LICENSE_KEY=eyJ2IjoxLCJjdXN0b21lciI6...

# AG Grid Enterprise license (data-grid block renders watermarked without it)
AG_GRID_LICENSE_KEY=

# OpenAI API key ("ask the grid" feature)
OPENAI_API_KEY=

# R2 backup (optional)
R2_ACCOUNT_ID=
R2_ACCESS_KEY_ID=
R2_SECRET_ACCESS_KEY=
R2_BUCKET=

Ejecuta los comandos openssl rand en tu terminal y pega los resultados. No los pierdas: son necesarios para acceder a la base de datos.

4. Descargar la imagen de Docker

Usa el token de GHCR que te enviamos por correo para iniciar sesión y descargar la imagen:

echo "ghp_xxxxxxxxxxxx" | docker login ghcr.io \
  -u egebilge --password-stdin

docker pull ghcr.io/egebilge/papyro:v1.0.0

5. Ejecutarlo

docker compose up -d

El arranque inicial tarda entre 30 y 60 segundos (se ejecutan las migraciones y se levantan los contenedores).

6. Crear el primer administrador

Abre https://papyro.yourdomain.com en un navegador. Aparece el asistente de configuración: introduce los datos de tu primer usuario. Este primer usuario se crea con el rol de superadministrador y el asistente se ejecuta una sola vez.

7. Verificar el estado de la licencia

Ve a Administración → Licencia (barra lateral). Deberían aparecer el nombre del cliente, la edición, el número de usuarios y la fecha de caducidad.

Resolución de problemas

LICENSE_KEY is not set

Cause / Sebep: Falta la variable de entorno o se copió de forma incorrecta.

Fix / Çözüm: Pega la línea exacta del correo de tu compra en .env. Reinicia: docker compose up -d --force-recreate app

LICENSE_KEY is invalid: malformed envelope

Cause / Sebep: El sobre se copió de forma incompleta (pegado truncado).

Fix / Çözüm: Selecciona y copia la línea LICENSE_KEY=... completa del correo. Debe contener un punto (.) dentro del valor.

LICENSE_KEY is invalid: invalid signature

Cause / Sebep: Versión de imagen incorrecta, o el sobre pertenece a otro binario de proveedor.

Fix / Çözüm: Comprueba la etiqueta de la imagen en tu comando docker pull. Para obtener ayuda, contacta con [email protected].

LICENSE_OVER_SEAT — Cannot add new user

Cause / Sebep: El límite de usuarios de tu licencia está completo.

Fix / Çözüm: Escribe a [email protected] para subir de nivel, o elimina usuarios baneados o inactivos.

Renovación

Te enviamos un correo 30 días antes de la caducidad. Tras el pago, llega una nueva LICENSE_KEY por correo. Sustituye el valor en .env y reinicia:

docker compose up -d --force-recreate app

Soporte

Correo: [email protected]

Respuesta en un plazo de 48 horas. Usa el prefijo «URGENT» en el asunto para emergencias.