Delete Artifactory users with jf rt users-delete
Delete users from Artifactory by username or from a CSV file.
Synopsis
jf rt users-delete <users-list> [options]
jf rt users-delete --csv <path> [options]
Aliases: rt udel
Arguments
| Argument | Required | Description |
|---|---|---|
<users-list> | If not using --csv | Comma-separated list of usernames: user1,user2,... |
Options
| Flag | Default | Description |
|---|---|---|
--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 | $CI | Set 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 --helpDelete Users by Name
To delete users by username:
- Run:
jf rt users-delete <users-list> --quietWhere:
<users-list>— comma-separated usernames (see Arguments).
Full example:
jf rt users-delete alice,bob --quietExpected 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:
- Create a CSV file with a
usernameheader and one username per row:
username
alice
bob- Run:
jf rt users-delete --csv <path> --quietWhere:
<path>— path to the CSV file (for example./users-to-remove.csv).
Full example:
jf rt users-delete --csv ./users-to-remove.csv --quietExpected 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.
--quietdefault: In CI environments (whenCIis set),--quietdefaults totrue.- Requires admin privileges on the Artifactory instance. Before running, verify your credentials are valid:
If this fails with a 401, refresh your token with
jf rt ping --server-id <your-server-id>jf config add <server-id>orjf config edit <server-id>. - Sequential processing: Users are deleted one at a time. If a user does not exist, the CLI logs an error for that user and continues with the remaining users in the list or CSV.
- Deleting a user does not remove them from groups. Clean up group memberships separately if needed.
- Trace ID on error: If an API error occurs, the CLI prints a
Trace ID for JFrog Platform logsvalue. You can share this ID with JFrog Support to help correlate server-side logs.
Updated about 1 month ago
