# Keycloak

Для того, чтобы развернуть Keycloack нам дополнительно понадобиться одна из следующих баз данных:

- MySQL
- PostgreSQL (рекомендуемая нами БД)

Инструкции как развернуть [MySQL](https://docs.amvera.ru/databases/mysql.html) и [PostgreSQL](https://docs.amvera.ru/databases/postgreSQL.html) на платформе Amvera

---
## Запуск Keycloak
Для развертывания Keycloak Вам потребуется выполнить следующие шаги:

### 1. Создать проект.
Выбираем:

- Тип: Преднастроенное приложение из маркетплейса
- Параметры сервиса: Авторизация
- Тип сервиса: Keycloak

![](../img/keycloack-create.jpg)

```{eval-rst}
.. admonition:: Важно
   :class: warning

Стабильная работа возможна на тарифах не ниже «Начальный».
```

### 2. На этапе «Конфигурация» настроить переменные окружения (envvars)

- KC_BOOTSTRAP_ADMIN_USERNAME — имя login администратора
- KC_BOOTSTRAP_ADMIN_PASSWORD — временный пароль администратора
- KC_DB — тип базы данных. Возможные значения:
\- mariadb
\- postgres
- KC_DB_URL_HOST — host базы данных
- KC_DB_URL_PORT — порт базы данных
- KC_DB_URL_DATABASE - имя базы данных
- KC_DB_USERNAME — имя пользователя базы данных
- KC_DB_PASSWORD — пароль базы данных

![keycloack-envvars](../img/keycloack-envvars.png)
### 3.В разделе «Настройки» приложения активировать [бесплатное доменное имя](https://docs.amvera.ru/applications/configuration/network.html#бесплатное-доменное-имя-амвера) или [добавить своё](https://docs.amvera.ru/applications/configuration/network.html#свое-доменное-имя)
![keycloack-domain](../img/keycloack-domain.png)

### 4. Добавить переменную KC_HOSTNAME ваше доменное имя
![keycloack-hostname](../img/keycloack-hostname.png)

### 5. Перезапустить проект
![keyckloack-restart-project](../img/keyckloack-restart-project.jpg)