Homarr
AdvancedCommand line interface

Users

This guide requires that you understand how to access the CLI.

Using these commands, you can manage the users from the CLI:

Group of commands to manage users

Usage:
  homarr users [command]

Available Commands:
  list              List all users (id, username, email)
  delete            Delete a user by id or username
  update-password   Update the password for a user (credentials provider only)

Flags:
  -h, --help      help for users
  -v, --version   version for homarr-cli

Use "homarr users [command] --help" for more information about a command.

List Users

  • Requires a database connection
ID                              Username        Email
yj52ek5cyb6du4bp4osbkjry        admin           xxxx@example.com
yj52ek5cyb6du4bp4osbkjry        admin           xxxx@example.com
yj52ek5cyb6du4bp4osbkjry        admin           xxxx@example.com
yj52ek5cyb6du4bp4osbkjry        admin           xxxx@example.com
yj52ek5cyb6du4bp4osbkjry        admin           xxxx@example.com
yj52ek5cyb6du4bp4osbkjry        admin           xxxx@example.com

Delete User

  • Requires a database connection
  • Requires one parameter: id or username
Delete a user by id or username

Usage:
  homarr users delete [flags]

Flags:
  -i, --id string         ID of the user
  -u, --username string   Name of the user
  -h, --help              help for users delete
  -v, --version           version for homarr-cli

Update Password

  • Updates the password of an user
  • Requires database connection
  • Requires either a username or id
  • Requires a password (which will be encrypted by Homarr)
Update the password for a user (credentials provider only)

Usage:
  homarr users update-password [flags]

Flags:
  -i, --id string         ID of the user
  -u, --username string   Name of the user
  -p, --password          New password
  -h, --help              help for users update-password
  -v, --version           version for homarr-cli

On this page