Remove JFrog CLI Server Configurations
jf config rm (remove) deletes one or all server entries from your local JFrog CLI configuration. Removing a server clears stored credentials for that ID. Omitting the server ID removes every configured server. Use --quiet to skip the confirmation prompt in an interactive terminal.
This topic covers:
Synopsis
jf config rm <server-id>Aliases: jf c rm
Where:
<server-id>: Optional. When provided, only that server is removed. When omitted, all servers are removed. Append flags such as--quietas needed.
Arguments
The following table describes command arguments.
| Argument | Required | Description |
|---|---|---|
server-id | No | Remove only this server. Omit to remove all |
Options
The following table describes command options.
| Flag | Default | Description |
|---|---|---|
--quiet | false | Skip the interactive confirmation prompt. Only applies when you run in an interactive terminal (TTY). In scripts and continuous integration and delivery (CI/CD) pipelines the prompt is suppressed automatically, so you do not need this flag there. |
Examples
Remove a Specific Server
To remove a specific server:
-
Run:
jf config rm <server-id> --quietWhere:
<server-id>: The ID of the server to remove.
For example:
jf config rm staging-server --quiet -
Confirm the configuration. No output is printed on success.
To verify the removal:
-
Run:
jf config show
Remove All Servers
To remove all configured servers:
-
Run:
jf config rm --quiet -
Confirm that no servers remain. No output is printed on success.
To verify all configurations are gone:
-
Run:
jf config showExpected: empty output (no servers configured).
Recover After Removing the Active Server
If you removed the currently active server, another server must become the default before JFrog CLI commands target a platform.
To set a different server as the active default:
-
Run:
jf config use <other-server-id>Where:
<other-server-id>: A server ID that remains in your configuration.
For example:
jf config use dev-server
Important Notes
- Destructive action. Removing a server configuration deletes its stored credentials permanently. You cannot undo this. After removing, run
jf config showto confirm the expected servers are no longer listed. - Remove all. Omitting the server ID removes all stored configurations. The
--quietflag skips the confirmation prompt in interactive terminal sessions. In CI/CD pipelines and non-interactive scripts, the prompt is suppressed automatically regardless of--quiet. - Active server. If you remove the active (default) server, there is no active server until you run
jf config use <other-id>or add a new one withjf config add. - CI/CD cleanup. In pipelines, add
jf config rm <server-id> --quietas a teardown step to avoid leaking credentials in ephemeral environments. - Non-existent server ID. If the specified
server-iddoes not exist, the JFrog CLI prints an informational message and exits 0. Confirm your server ID withjf config showbefore you run remove in automation scripts. - Empty output after remove all. After removing all servers,
jf config showreturns empty output with exit code 0. This is expected. It does not indicate an error.
Updated 25 days ago
For more information about configuring a new server, see Add a JFrog CLI server configuration.
