Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 9, 2022

gnome-keyring-daemon (1)


gnome-keyring-daemon - keyring daemon


gnome-keyring-daemon [OPTION...]


GNOME-KEYRING-DAEM(1)            User Commands           GNOME-KEYRING-DAEM(1)

       gnome-keyring-daemon - The gnome-keyring daemon

       gnome-keyring-daemon [OPTION...]

       The gnome-keyring-daemon is a service that stores your passwords and
       secrets. It is normally started automatically when a user logs into a
       desktop session.

       The gnome-keyring-daemon implements the DBus Secret Service API, and
       you can use tools like seahorse or secret-tool to interact with it.

       The daemon also implements a GnuPG and SSH agent both of which
       automatically load the user's keys, and prompt for passwords when

       The daemon will print out various environment variables which should be
       set in the user's environment, in order to interact with the daemon.

       The various startup arguments below can be used:

       -c, --components=ssh,secrets,pkcs11
           Ask the daemon to only initialize certain components. Valid
           components are ssh, secrets, pkcs11.

           By default all components are initialized.

       -C, --control-directory=/path/to/directory
           Use this directory for creating communication sockets. By default a
           temporary directory is automatically created.

       -d, --daemonize
           Run as a real daemon, disconnected from the terminal.

       -f, --foreground
           Run in the foreground, and do not fork or become a daemon.

       -l, --login
           This argument tells the daemon it is being run by PAM. It reads all
           of stdin (including any newlines) as a login password and does not
           complete actual initialization.

           The daemon should later be initialized with a
           gnome-keyring-daemon --start invocation.

           This option implies --unlock. It may not be used together with
           either the --replace or --start arguments.

       -r, --replace
           Try to replace a running keyring daemon, and assume its environment
           variables. A successful replacement depends on the
           GNOME_KEYRING_CONTROL environment variable being set by an earlier

           This option may not be used together with either the --login or
           --start arguments.

       -s, --start
           Connect to an already running daemon and initialize it. This is
           often used to complete initialization of a daemon that was started
           by PAM using the --login argument.

           This option may not be used together with either the --login or
           --replace arguments.

           Read a password from stdin, and use it to unlock the login keyring
           or create it if the login keyring does not exist.

       -V, --version
           Print out the gnome-keyring version and then exit.

       -h, --help
           Show help options and exit.

       Please send bug reports to either the distribution bug tracker or the
       upstream bug tracker at

       See attributes(7) for descriptions of the following attributes:

       |Availability   | gnome/gnome-keyring   |
       |Stability      | Pass-through volatile |

       secret-tool(1), seahorse(1)

       Further details available in the gnome-keyring online documentation at
       https://wiki.gnome.org/GnomeKeyring and in the secret-service online
       documentation at http://standards.freedesktop.org/secret-service/

       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from  https://download.gnome.org/sources/gnome-

       Further information about this software can be found on the open source
       community website at https://wiki.gnome.org/Projects/GnomeKeyring.

gnome-keyring                                            GNOME-KEYRING-DAEM(1)