> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-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 %}

Розгортання legacy docker-compose.yml:

{% code title="Legacy 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 UI

* Увійдіть як наявний адміністратор.
* Натисніть 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 %}

Розгортання legacy docker-compose.yml:

{% code title="Legacy 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.
* Знайдіть користувача, якого хочете відновити.
* Натисніть кнопку Display deleted users.
* Натисніть на адресу електронної пошти видаленого користувача.
* Натисніть Recover This Account.
* Натисніть Recover, щоб підтвердити.
  {% 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 %}

Загальна кількість користувачів за допомогою endpoint метрик:

{% 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://overleaf-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.