Try JFrog
Guides
Contact SupportTry JFrog
  1. CLI
  2. Manage configuration entities
  3. Create a user in Artifactory

Delete Artifactory users with jf rt users-delete

Delete Artifactory users by name or CSV file with JFrog CLI.

Delete users from Artifactory by username or from a CSV file. To add users instead, see jf rt users-create.

Synopsis

jf rt users-delete <users-list> [options]
jf rt users-delete --csv <path> [options]

Aliases: rt udel

Arguments

The following table lists the positional argument for jf rt users-delete.

ArgumentRequiredDescription
<users-list>If not using --csvComma-separated list of usernames: user1,user2,...

Options

The following table lists the flags supported by jf rt users-delete.

FlagDefaultDescription
--access-token—JFrog access token
--csv—Path to a CSV file. First row must be the header username. Extra columns are ignored.
--password—JFrog password (for authentication)
--quiet$CISet to true to skip the delete confirmation message
--server-id—Server ID configured using the jf config command
--ssh-key-path—SSH key file path
--ssh-passphrase—SSH key passphrase
--url—JFrog Artifactory URL (example: https://acme.jfrog.io/artifactory)
--user—JFrog username

Examples

Verify Command Help

To view command help:

  • Run:
jf rt users-delete --help

Delete Users by Name

To delete users by username:

  • Run:
jf rt users-delete <users-list> --quiet

Where:

  • <users-list> — comma-separated usernames (see Arguments).

Full example:

jf rt users-delete alice,bob --quiet

Expected output (one line per user, exits 0 on success):

[Info] Deleting user alice...
[Info] Deleting user bob...

Delete Users from a CSV File

To delete users listed in a CSV file:

  1. Create a CSV file with a username header and one username per row:
username
alice
bob
  1. Run:
jf rt users-delete --csv <path> --quiet

Where:

  • <path> — path to the CSV file (for example ./users-to-remove.csv).

Full example:

jf rt users-delete --csv ./users-to-remove.csv --quiet

Expected output (one line per user, exits 0 on success):

[Info] Deleting user alice...
[Info] Deleting user bob...
🚧

Warning

This action permanently removes users. You cannot undo it.

Important Notes

  • Irreversible: Deleted users cannot be recovered. Their artifacts and builds remain, but their account and authentication credentials are permanently removed.
  • --quiet default: In CI environments (when CI is set), --quiet defaults to true.
  • Requires admin privileges on the Artifactory instance. Before running, verify your credentials are valid: 
    jf rt ping --server-id <your-server-id>
    If this fails with a 401, refresh your token with jf config add <server-id> or jf config edit <server-id>.
  • Sequential processing: Users are deleted one at a time, in list/CSV order, and processing stops at the first error. If a user does not exist (or any other deletion error occurs), the CLI reports the error and does not proceed to the remaining users in the list or CSV. Users listed after the failing one are left untouched. Re-run the command with the corrected/remaining list to continue.
  • Deleting a user does not remove them from groups. Clean up group memberships separately using Group Management commands if needed.
  • Trace ID on error: If an API error occurs, the CLI prints a Trace ID for JFrog Platform logs value. You can share this ID with JFrog Support to help correlate server-side logs.

Frequently Asked Questions

This section provides answers to frequently asked questions.

plusFAQs
Q: How do I delete multiple Artifactory users at once?

A: Run jf rt users-delete <users-list> --quiet with a comma-separated list of usernames, or use --csv <path> to delete users listed in a CSV file. See Delete Users by Name.

Q: What happens if one user in my list doesn't exist?

A: Processing stops at the first error, and the CLI does not continue to the remaining users in the list or CSV. See Important Notes.

Q: What permissions do I need to run jf rt users-delete?

A: You need admin privileges on the Artifactory instance, and your credentials must be valid. See Important Notes.

Q: Does --quiet skip the confirmation prompt every time?

A: --quiet skips the delete confirmation message when set to true, and it defaults to true automatically in CI environments (when CI is set).

Q: Does deleting a user remove them from their groups?

A: No. Deleting a user does not remove them from groups. Clean up group memberships separately using Group Management.

Related Topics


Updated 2 days ago

What’s Next

Next, organize users into groups. See Group Management.

Did this page help you?