diff options
author | rinpatch <rinpatch@sdf.org> | 2019-10-03 10:15:24 +0300 |
---|---|---|
committer | rinpatch <rinpatch@sdf.org> | 2019-10-03 10:15:24 +0300 |
commit | b4ca864c6b2e6ee9addea7fbc0b09fca581816ce (patch) | |
tree | d6c636a6abb20901df7fb214d76be530aaa724f7 /docs/administration | |
parent | 8fd47a4a5a9704a523046e7b8d2cdac3f090acea (diff) | |
download | pleroma-b4ca864c6b2e6ee9addea7fbc0b09fca581816ce.tar.gz pleroma-b4ca864c6b2e6ee9addea7fbc0b09fca581816ce.zip |
Move user tasks docs to a separate file
Diffstat (limited to 'docs/administration')
-rw-r--r-- | docs/administration/CLI_tasks/user.md | 94 |
1 files changed, 94 insertions, 0 deletions
diff --git a/docs/administration/CLI_tasks/user.md b/docs/administration/CLI_tasks/user.md new file mode 100644 index 000000000..045730753 --- /dev/null +++ b/docs/administration/CLI_tasks/user.md @@ -0,0 +1,94 @@ +# Managing users + +Every command should be ran with a prefix, in case of OTP releases it is `./bin/pleroma_ctl user` and in case of source installs it's `mix pleroma.user`. + +## Create a user +```sh +$PREFIX new <nickname> <email> [<options>] +``` + +### Options +- `--name <name>` - the user's display name +- `--bio <bio>` - the user's bio +- `--password <password>` - the user's password +- `--moderator`/`--no-moderator` - whether the user should be a moderator +- `--admin`/`--no-admin` - whether the user should be an admin +- `-y`, `--assume-yes`/`--no-assume-yes` - whether to assume yes to all questions + +## Generate an invite link +```sh +$PREFIX invite [<options>] +``` + +### Options +- `--expires-at DATE` - last day on which token is active (e.g. "2019-04-05") +- `--max-use NUMBER` - maximum numbers of token uses + +## List generated invites +```sh +$PREFIX invites +``` + +## Revoke invite +```sh +$PREFIX revoke_invite <token_or_id> +``` + +## Delete a user +``` +$PREFIX rm <nickname> +``` + +## Delete user's posts and interactions +```sh +$PREFIX delete_activities <nickname> +``` + +## Sign user out from all applications (delete user's OAuth tokens and authorizations) +```sh +$PREFIX sign_out <nickname> +``` + +## Deactivate or activate a user +```sh +$PREFIX toggle_activated <nickname> +``` + +## Unsubscribe local users from a user and deactivate the user +```sh +$PREFIX unsubscribe NICKNAME +``` + +## Unsubscribe local users from an instance and deactivate all accounts on it +```sh +$PREFIX unsubscribe_all_from_instance <instance> +``` + +## Create a password reset link for user +```sh +$PREFIX reset_password <nickname> +``` + +## Set the value of the given user's settings +```sh +$PREFIX set <nickname> [<options>] +``` +### Options +- `--locked`/`--no-locked` - whether the user should be locked +- `--moderator`/`--no-moderator` - whether the user should be a moderator +- `--admin`/`--no-admin` - whether the user should be an admin + +## Add tags to a user +```sh +$PREFIX tag <nickname> <tags> +``` + +## Delete tags from a user +```sh +$PREFIX untag <nickname> <tags> +``` + +## Toggle confirmation status of the user +```sh +$PREFIX toggle_confirmed <nickname> +``` |