Установка за 15 минут

Установка Papyro

Это руководство проведёт вас через установку Papyro на вашем собственном сервере. Предполагается базовое знание Docker.

1. Требования

Docker 24+ и docker compose v2
Минимум 2 ГБ ОЗУ, 10 ГБ диска
Обратный прокси с HTTPS (Cloudflare, Traefik, nginx)
Домен или поддомен (например, papyro.yourcompany.com)
Ваш приобретённый LICENSE_KEY (отправлен по email)
Ваш токен GHCR (для загрузки образа, отправлен по email)

2. Настройка рабочего каталога

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. Заполните файл .env

Вставьте значения из письма о покупке:

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

Выполните команды openssl rand в терминале и вставьте их вывод. Не теряйте эти значения — они нужны для доступа к БД.

4. Загрузите Docker-образ

Используйте токен GHCR, который мы отправили вам по email, чтобы войти и загрузить образ:

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

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

5. Запустите

docker compose up -d

Первоначальный запуск занимает 30–60 секунд (выполняются миграции, поднимаются контейнеры).

6. Создайте первого администратора

Откройте https://papyro.yourdomain.com в браузере. Появится мастер настройки — введите данные первого пользователя. Этот первый пользователь создаётся с ролью super-admin, а мастер запускается ровно один раз.

7. Проверьте статус лицензии

Перейдите в Admin → License (боковая панель). Должны отобразиться имя клиента, редакция, количество мест и дата истечения.

Устранение неполадок

LICENSE_KEY is not set

Cause / Sebep: Переменная окружения отсутствует или скопирована неверно.

Fix / Çözüm: Вставьте точную строку из письма о покупке в .env. Перезапустите: docker compose up -d --force-recreate app

LICENSE_KEY is invalid: malformed envelope

Cause / Sebep: Конверт скопирован не полностью (обрезанная вставка).

Fix / Çözüm: Выделите и скопируйте всю строку LICENSE_KEY=... из письма. Значение должно содержать точку (.).

LICENSE_KEY is invalid: invalid signature

Cause / Sebep: Неверная версия образа или конверт принадлежит бинарнику другого поставщика.

Fix / Çözüm: Проверьте тег образа в вашей команде docker pull. За помощью обращайтесь на [email protected].

LICENSE_OVER_SEAT — Cannot add new user

Cause / Sebep: Лимит мест вашей лицензии исчерпан.

Fix / Çözüm: Напишите на [email protected] для повышения тарифа или удалите заблокированных/неактивных пользователей.

Продление

Мы пишем вам по email за 30 дней до истечения. После оплаты новый LICENSE_KEY приходит по email. Замените значение в .env и перезапустите:

docker compose up -d --force-recreate app

Поддержка

Email: [email protected]

Ответ в течение 48 часов. Для срочных вопросов используйте префикс темы «URGENT».