# Установка ПринтМенеджера — шифрование конфигурационного файла

## Цель

Установить ПринтМенеджер с активацией шифрования конфигурационного файла для защиты чувствительных данных конфигурации.

## Предусловия

- Сервер соответствует требованиям из страницы «Требования к серверу для установки Принтум».
- Подготовлены команды для онлайн- или офлайн-установки ПринтМенеджера.

## Что потребуется

- IP-адрес сервера.
- Пароль шифрования для переменной `ENV_VAULT_PASSWORD`.

## Шаги установки

### Шаг 1. Выбрать способ установки и добавить переменную шифрования

Для активации шифрования конфигурационного файла при установке ПринтМенеджера необходимо дополнительно задать переменную `ENV_VAULT_PASSWORD`.

### Шаг 2. Установка с шифрованием

##### Онлайн установка:

Подключитесь к серверу по SSH и выполните команду:

```
sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E PM_HOSTNAME=<ip> ENV_VAULT_PASSWORD=<password> bash
```

##### Офлайн установка: 

Перейдите в каталог с установочным скриптом и выполните команду:

```
sudo PM_HOSTNAME=<ip> ENV_VAULT_PASSWORD=<password> -E ./install.sh
```

### Шаг 3. Ввести пароль повторно

В процессе установки необходимо будет повторно ввести пароль.

## Ожидаемый результат

- Установка завершается без ошибок.
- Конфигурационный файл ПринтМенеджера зашифрован.
- Панель администратора («зелёная админка») доступна по адресу `https://<ip_address>:8080/config/`.

## Как проверить установку

- Открыть в браузере URL панели администратора ПринтМенеджера.
- Авторизоваться с учётными данными по умолчанию: логин `printum`, пароль `printum`.

## Следующие шаги

- «Завершение установки ПринтМенеджера — первый вход и проверка»
- «Обновление сертификатов»

## Типовые ошибки

- **Пароли не совпадают при повторном вводе** — в процессе установки система запросит повторный ввод `ENV_VAULT_PASSWORD`; ввести точно тот же пароль.
- **Пароль шифрования утерян** — конфигурационный файл не может быть расшифрован без `ENV_VAULT_PASSWORD`; пароль необходимо сохранить в защищённом месте.
- **sha512sum выдал ошибку (при офлайн-установке)** — архив повреждён; скачать заново или обратиться в поддержку.

## Связанные страницы

- [Требования к серверу для установки Принтум](http://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-serveru-dlia-ustanovki-printum)
- [Установка ПринтМенеджера — онлайн, автоматические сертификаты](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-printmenedzera-onlain-avtomaticeskie-sertifikaty)
- [Установка ПринтМенеджера — офлайн, автоматические сертификаты](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-printmenedzera-oflain-avtomaticeskie-sertifikaty)
- [Завершение установки ПринтМенеджера — первый вход и проверка](http://wiki.printum.io/books/3-ustanovka/page/zaversenie-ustanovki-printmenedzera-pervyi-vxod-i-proverka)