Installation en 15 minutes

Installer Papyro

Ce guide vous accompagne dans l'installation de Papyro sur votre propre serveur. Des connaissances de base de Docker sont supposées.

1. Prérequis

Docker 24+ et docker compose v2
Minimum 2 Go de RAM, 10 Go de disque
Reverse proxy avec HTTPS (Cloudflare, Traefik, nginx)
Un domaine ou sous-domaine (p. ex. papyro.yourcompany.com)
Votre LICENSE_KEY achetée (envoyée par e-mail)
Votre jeton GHCR (pour la récupération de l'image, envoyé par e-mail)

2. Configurer le répertoire de travail

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. Renseigner le fichier .env

Collez les valeurs issues de votre e-mail d'achat :

# 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=

Exécutez les commandes openssl rand dans votre terminal et collez les résultats. Ne les perdez pas — ils sont nécessaires pour accéder à la base de données.

4. Récupérer l'image Docker

Utilisez le jeton GHCR que nous vous avons envoyé par e-mail pour vous connecter et récupérer l'image :

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

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

5. Lancer l'application

docker compose up -d

Le démarrage initial prend 30 à 60 secondes (les migrations s'exécutent, les conteneurs démarrent).

6. Créer le premier administrateur

Ouvrez https://papyro.yourdomain.com dans un navigateur. L'assistant de configuration apparaît — saisissez les informations de votre premier utilisateur. Ce premier utilisateur est créé avec le rôle de super-administrateur et l'assistant ne s'exécute qu'une seule fois.

7. Vérifier l'état de la licence

Allez dans Admin → Licence (barre latérale). Votre nom de client, votre édition, votre nombre d'utilisateurs et votre date d'expiration devraient apparaître.

Dépannage

LICENSE_KEY is not set

Cause / Sebep: Variable d'environnement manquante ou copiée incorrectement.

Fix / Çözüm: Collez la ligne exacte de votre e-mail d'achat dans .env. Redémarrez : docker compose up -d --force-recreate app

LICENSE_KEY is invalid: malformed envelope

Cause / Sebep: L'enveloppe a été copiée de façon incomplète (collage tronqué).

Fix / Çözüm: Sélectionnez et copiez l'intégralité de la ligne LICENSE_KEY=... depuis l'e-mail. Elle doit contenir un point (.) dans la valeur.

LICENSE_KEY is invalid: invalid signature

Cause / Sebep: Mauvaise version d'image, ou l'enveloppe appartient à un binaire d'un autre fournisseur.

Fix / Çözüm: Vérifiez le tag de l'image dans votre commande docker pull. Pour obtenir de l'aide, contactez [email protected].

LICENSE_OVER_SEAT — Cannot add new user

Cause / Sebep: La limite d'utilisateurs de votre licence est atteinte.

Fix / Çözüm: Écrivez à [email protected] pour passer à un niveau supérieur, ou supprimez les utilisateurs bannis/inactifs.

Renouvellement

Nous vous envoyons un e-mail 30 jours avant l'expiration. Après le paiement, une nouvelle LICENSE_KEY arrive par e-mail. Remplacez la valeur dans .env et redémarrez :

docker compose up -d --force-recreate app

Support

E-mail : [email protected]

Réponse sous 48 heures. Utilisez le préfixe d'objet « URGENT » pour les urgences.