> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/uk/keruvannya-koristuvachami-ta-proyektami/user-management.md).

# Керування користувачами

## Створення користувача-адміністратора

Розгортання Overleaf Toolkit:

{% code title="Overleaf Toolkit" overflow="wrap" %}

```bash
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com"
```

{% endcode %}

Розгортання застарілого docker-compose.yml:

{% code title="Застарілий docker-compose" overflow="wrap" %}

```bash
$ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com"
```

{% endcode %}

Команда створить користувача із вказаною електронною адресою, якщо він ще не існує, і зробить його адміністратором. Вивід команди містить URL, який потрібно відвідати, щоб встановити пароль для цього користувача та вперше увійти в систему.

{% hint style="info" %}
Для програмного підходу ви також можете використати той самий сценарій для створення звичайних користувачів, а також адміністраторів. Для звичайних користувачів не вказуйте прапорець --admin.
{% endhint %}

Якщо ви використовуєте внутрішні облікові записи для автентифікації та потрібно підвищити існуючого користувача до адміністратора інстансу або відкликати права адміністратора, виконайте таке:

{% stepper %}
{% step %}

### Через інтерфейс адміністратора

* Увійдіть як наявний адміністратор.
* Натисніть Admin -> Manage Users.
* Знайдіть користувача та натисніть на його електронну адресу.
* Прокрутіть униз до розділу Site Admin і натисніть посилання (show).
* Поставте позначку в полі Is Site Admin.
* Натисніть Save, щоб завершити.
  {% endstep %}
  {% endstepper %}

***

## Видалення користувачів

Як пояснено в нашому посібнику щодо [розуміння використання ліцензії](broken://pages/110423d8a22828c1a8ead71bbb1ae8907e6e5de0), зазвичай не рекомендується видаляти облікові записи, якщо вони більше не потрібні. Видалення облікового запису прибирає сам обліковий запис і призводить до втрати доступу до проєктів для співавторів. Наразі немає способу деактивувати облікові записи — вони або існують із збереженими даними, або видаляються.

За замовчуванням облікові записи видаляються м'яко. Щоб дізнатися про остаточне видалення користувачів з вашого інстансу, див. `ENABLE_CRON_RESOURCE_DELETION` у [Змінні середовища](broken://pages/2db6c85df4994d46e27a99e0d121414d97e0f879) посібник.

{% hint style="info" %}
За замовчуванням облікові записи видаляються м'яко. Див. `ENABLE_CRON_RESOURCE_DELETION` щоб дізнатися про поведінку остаточного видалення.
{% endhint %}

### Через Admin -> Manage Users

{% stepper %}
{% step %}

* Увійдіть як адміністратор.
* Натисніть Admin -> Manage Users.
* Знайдіть користувача і поставте позначку біля його електронної адреси.
* Натисніть на значок кошика.
* Натисніть Delete, щоб підтвердити.
  {% endstep %}
  {% endstepper %}

### Через командний рядок

Облікові записи користувачів (і їхні проєкти) можна видалити за допомогою наведених нижче команд.

Розгортання Overleaf Toolkit:

{% code title="Overleaf Toolkit" %}

```bash
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com"
```

{% endcode %}

Розгортання застарілого docker-compose.yml:

{% code title="Застарілий docker-compose" %}

```bash
$ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com"
```

{% endcode %}

{% hint style="danger" %}
Сценарій видалення використовує жорстко задану опцію force, яка забезпечує виконання видалення навіть якщо електронний лист про видалення облікового запису не вдається надіслати (наприклад, коли електронна адреса користувача більше не обслуговується).
{% endhint %}

{% hint style="info" %}
Починаючи з версії 5.5.0, можна використовувати параметр --skip-email, щоб запобігти надсиланню інформативного листа видаленому користувачу.
{% endhint %}

***

## Відновлення м'яко видаленого користувача

Якщо користувача було лише м'яко видалено, ви можете відновити його обліковий запис і проєкти.

{% stepper %}
{% step %}

* Увійдіть як адміністратор.
* Натисніть Admin -> Manage Users.
* Знайдіть користувача, якого ви хочете відновити.
* Натисніть кнопку Показати видалених користувачів.
* Натисніть на електронну адресу видаленого користувача.
* Натисніть Відновити цей обліковий запис.
* Натисніть Відновити, щоб підтвердити.
  {% endstep %}
  {% endstepper %}

{% hint style="danger" %}
Коли ENABLE\_CRON\_RESOURCE\_DELETION має значення true, м'яко видалені облікові записи можна відновити протягом 90-денного вікна. Після 90 днів відновлення облікового запису неможливе.
{% endhint %}

***

## Підрахунок користувачів

Ви можете отримати кількість користувачів через інтерфейс адміністратора за адресою <https://you-instance-url/admin/user#license>. Для програмних перевірок і експорту можуть стати у пригоді такі приклади.

Загальна кількість користувачів:

{% code title="Загальна кількість користувачів" %}

```bash
echo 'db.users.countDocuments()' | docker exec -i mongo mongosh --quiet localhost/sharelatex
# overleaf [direct: primary] sharelatex> 16
```

{% endcode %}

Загальна кількість користувачів, що використовує кінцеву точку метрик:

{% code title="Кількість активних користувачів із метрик" %}

```bash
docker exec sharelatex curl http://127.0.0.1:3000/metrics | grep num_active_users
# # HELP num_active_users num_active_users
# # TYPE num_active_users gauge
# num_active_users{app="web-api",host="b3ae4ff549d8"} 16
```

{% endcode %}

Загальна кількість активних користувачів (приклад: користувачі, активні протягом останніх 365 днів):

{% code title="Загальна кількість активних користувачів" %}

```bash
echo 'db.users.countDocuments({ lastActive: { $gte: new Date(new Date().getTime() - (365 * 24 * 60 * 60 * 1000)) } })' | docker exec -i mongo mongosh --quiet localhost/sharelatex
# overleaf [direct: primary] sharelatex> 10
```

{% endcode %}

***

## Оновлення інформації про обліковий запис користувача

Те, як виконуються оновлення облікового запису, залежить від того, чи ввімкнено SSO.

* Якщо SSO не використовується:
  * Адміністратори можуть змінювати інформацію про обліковий запис користувача через Admin -> Manage Users (електронна адреса, ім'я, прізвище та створення посилання для скидання пароля).
  * Звичайні користувачі можуть оновлювати свої дані через Account -> Account Settings (включно зі зміною пароля та створенням токенів автентифікації Git).
* Якщо використовується SSO:
  * Server Pro можна налаштувати так, щоб під час входу оновлювалися ім'я та прізвище користувача на основі системи автентифікації.
  * Коли OVERLEAF\_SAML\_UPDATE\_USER\_DETAILS\_ON\_LOGIN або OVERLEAF\_LDAP\_UPDATE\_USER\_DETAILS\_ON\_LOGIN мають значення true, форма даних користувача на <https://your-instance-url/user/settings> вимкнена, а ім'я/прізвище можна встановити лише у вашій системі керування ідентичностями.

Докладніше дивіться:

* Конфігурація SAML 2.0: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/saml-2.0>
* Конфігурація LDAP: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/ldap>

***

Останнє оновлення 4 місяці тому

Ця сторінка документації містить посилання на зовнішні посібники та сторінки конфігурації. Усі посилання та параметри запиту збережено так, як в оригінальному вмісті.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/uk/keruvannya-koristuvachami-ta-proyektami/user-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.