Forrest logo
back to the nmcli tool

nmcli-agent:tldr:316cb

nmcli-agent: Register nmcli as a secret agent and listen for secret requests.
$ nmcli agent secret
try on your machine

The nmcli agent secret command is used to view and manage the NetworkManager secrets stored by the nmcli command-line tool.

In NetworkManager, secrets are used to store sensitive information like Wi-Fi passwords and VPN credentials. The nmcli agent secret command allows you to interact with these secrets.

To view the stored secrets, you need to have the necessary permissions or provide the root password. After executing the command, you will see a list of secrets along with their UUIDs, connection IDs, secret types, and flags.

Additionally, the command provides options to add, modify, delete, or unlock secrets. These actions require administrative privileges to perform.

Here are some commonly used subcommands with nmcli agent secret:

  • nmcli agent secret list: Displays all the secret entries.
  • nmcli agent secret unlock [UUID]: Unlocks a secret using the specified UUID.
  • nmcli agent secret delete [UUID]: Deletes a secret using the specified UUID.
  • nmcli agent secret modify [UUID]: Allows you to modify properties of a secret.

Remember, you may need to prefix the command with sudo to run it with root privileges if you are not already logged in as the root user.

It's important to handle secrets with care, as they contain sensitive information.

This explanation was created by an AI. In most cases those are correct. But please always be careful and never run a command you are not sure if it is safe.
back to the nmcli tool