Skip to content

Managing users

Every command should be ran as the pleroma user from it's home directory. For example if you are superuser, you would have to wrap the command in su pleroma -s $SHELL -lc "$COMMAND".

From source note about MIX_ENV

The mix command should be prefixed with the name of environment your Pleroma server is running in, usually it's MIX_ENV=prod

Create a user

./bin/pleroma_ctl user new <nickname> <email> [option ...]
mix pleroma.user new <nickname> <email> [option ...]


  • --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

List local users

 ./bin/pleroma_ctl user list
mix pleroma.user list
 ./bin/pleroma_ctl user invite [option ...]
mix pleroma.user invite [option ...]


  • --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

 ./bin/pleroma_ctl user invites
mix pleroma.user invites

Revoke invite

 ./bin/pleroma_ctl user revoke_invite <token>
mix pleroma.user revoke_invite <token>

Delete a user

 ./bin/pleroma_ctl user rm <nickname>
mix pleroma.user rm <nickname>

Delete user's posts and interactions

 ./bin/pleroma_ctl user delete_activities <nickname>
mix pleroma.user delete_activities <nickname>

Sign user out from all applications (delete user's OAuth tokens and authorizations)

 ./bin/pleroma_ctl user sign_out <nickname>
mix pleroma.user sign_out <nickname>

Deactivate or activate a user

 ./bin/pleroma_ctl user toggle_activated <nickname>
mix pleroma.user toggle_activated <nickname>

Deactivate a user and unsubscribes local users from the user

 ./bin/pleroma_ctl user deactivate NICKNAME
mix pleroma.user deactivate NICKNAME

Deactivate all accounts from an instance and unsubscribe local users on it

 ./bin/pleroma_ctl user deactivate_all_from_instance <instance>
mix pleroma.user deactivate_all_from_instance <instance>
 ./bin/pleroma_ctl user reset_password <nickname>
mix pleroma.user reset_password <nickname>

Disable Multi Factor Authentication (MFA/2FA) for a user

 ./bin/pleroma_ctl user reset_mfa <nickname>
mix pleroma.user reset_mfa <nickname>

Set the value of the given user's settings

 ./bin/pleroma_ctl user set <nickname> [option ...]
mix pleroma.user set <nickname> [option ...]


  • --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

 ./bin/pleroma_ctl user tag <nickname> <tags>
mix pleroma.user tag <nickname> <tags>

Delete tags from a user

 ./bin/pleroma_ctl user untag <nickname> <tags>
mix pleroma.user untag <nickname> <tags>

Toggle confirmation status of the user

 ./bin/pleroma_ctl user toggle_confirmed <nickname>
mix pleroma.user toggle_confirmed <nickname>