# Установка ПринтМенеджера — онлайн, автоматические сертификаты

## Цель

Установить ПринтМенеджер на сервер с выходом в интернет с использованием автоматически генерируемых системой SSL-сертификатов. Подходит, когда собственные сертификаты не требуются.

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

- Сервер соответствует требованиям из страницы «Требования к серверу для установки Принтум».
- Сервер имеет выход в интернет и доступ к `https://s3.printum.io`.
- Подключение к серверу по SSH под пользователем с правами sudo.
- Установлен `curl`.
- Если нет выхода в интернет, переходите к разделу «Установка ПринтМенеджера — офлайн, автоматические сертификаты».

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

- IP-адрес сервера или доменное имя (хостнейм).
- При желании — пароль для суперпользователя.
- При нестандартных портах — номера портов HTTP и HTTPS.

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

### Шаг 1. Подключиться к серверу по SSH

```
ssh username@ip_address
```

Где `username` —логин пользователя на сервере, а `ip_address` — адрес удаленного сервера.

После ввода этой команды нужно будет ввести пароль от учетной записи для подключения.

### Шаг 2. (Опционально) Задать пароль суперпользователя

Если требуется задать пароль администратора ПринтМенеджера на этапе установки:

```
export PM_ADMIN_PASSWORD=<пароль>
```

Пароль можно задать и позже.

### Шаг 3. (Опционально) Задать нестандартные порты

Если требуется установить ПринтМенеджер с нестандартными портами:

```
export PM_HTTP_PORT=x
```

где `x` — порт для http протокола.

```
export PM_HTTPS_PORT=x
```

где `x` — порт для https протокола.

### Шаг 4. Запустить установку

Установка с адресацией по IP-адресу и с использованием автоматических сертификатов:

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

где `<ip>` — IP-адрес сервера. Не используйте адреса из пула `10.28.32.0/26`, они используются внутренней сетью.

Установка с адресацией по доменному имени и с использованием автоматических сертификатов:

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

где `<hostname>` — доменное имя сервера.

### Шаг 5. (Опционально) Установка на выделенный сервер

Для установки ПринтМенеджера на выделенный сервер (отдельно от Мониторинга) добавьте в команду установки переменную `MONITORING_ADDRESS`:

```
sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E MONITORING_ADDRESS=<mon_hostname_or_ip> PM_HOSTNAME=<hostname> bash
```

где `<mon_hostname_or_ip>` — доменное имя или IP-адрес сервера мониторинга.

### Шаг 6. Дождаться завершения установки

При установке автоматически происходит сравнение чек-суммы (алгоритм sha512) скачанного архива с файлом на сервере для подтверждения его целостности. Среднее время установки — 10–20 минут.

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

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

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

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

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

- «Завершение установки ПринтМенеджера — первый вход и проверка»
- «Установка ПринтМенеджера — подключение к внешней PostgreSQL» (если нужна внешняя БД)

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

- **curl недоступен на сервере** — установить пакет `curl` или перейти к офлайн-установке.
- **Нет доступа к https://s3.printum.io** — проверить интернет-соединение сервера; при отсутствии доступа использовать офлайн-установку.
- **Авторизация на панели администратора не проходит** — если при установке задавался `PM_ADMIN_PASSWORD`, использовать его вместо пароля по умолчанию `printum`.
- **Браузер предупреждает о недоверенном сертификате** — при автоматически генерируемых сертификатах предупреждение ожидаемо; для устранения используйте собственные сертификаты.
- **Адрес из пула 10.28.32.0/26** — эти адреса используются внутренней сетью; выбрать другой IP-адрес сервера.

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

- [Требования к серверу для установки Принтум](http://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-serveru-dlia-ustanovki-printum)
- [Требования к сетевой доступности и портам](http://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-setevoi-dostupnosti-i-portam)
- [Установка ПринтМенеджера — онлайн, собственные сертификаты](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-printmenedzera-onlain-sobstvennye-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)
- [Синхронизация Мониторинга и ПринтМенеджера](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/sinxronizaciia-monitoringa-i-printmenedzera)