Introduction to libsecret

The libsecret package contains a GObject based library for accessing the Secret Service API.



Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

libsecret Dependencies





Gi-DocGen-2023.1 and docbook-xml-4.5, docbook-xsl-nons-1.79.2, libxslt-1.1.38 (to build manual pages), and Valgrind-3.21.0 (can be used in tests)

Optional (Required for the test suite)

D-Bus Python-1.3.2, Gjs-1.78.0, PyGObject-3.46.0 (Python 3 module), and tpm2-tss

Runtime Dependency




Any package requiring libsecret expects GNOME Keyring to be present at runtime.

Installation of libsecret

Install libsecret by running the following commands:

mkdir bld &&
cd    bld &&

meson setup --prefix=/usr       \
            --buildtype=release \
            -Dgtk_doc=false     \
            ..                  &&

If you have Gi-DocGen-2023.1 installed and wish to build the API documentation for this package, issue:

sed "s/api_version_major/'0.21.1'/"            \
    -i ../docs/reference/libsecret/ &&
meson configure -Dgtk_doc=true                 &&

Now, as the root user:

ninja install

To test the results, issue: dbus-run-session ninja test.

Command Explanations

--buildtype=release: Specify a buildtype suitable for stable releases of the package, as the default may produce unoptimized binaries.

-Dgtk_doc=false: Allow building this package without Gi-DocGen-2023.1 installed. If you have Gi-DocGen-2023.1 installed and you wish to rebuild and install the API documentation, a meson configure command will reset this option.

-Dmanpage=false: Use this switch if you have not installed libxslt-1.1.38 and DocBook packages.

-Dgcrypt=false: Use this switch if you have not installed the recommended dependency of libgcrypt-1.10.2.


Installed Program: secret-tool
Installed Library:
Installed Directories: /usr/include/libsecret-1 and /usr/share/doc/libsecret-0.21.1

Short Descriptions


is a command line tool that can be used to store and retrieve passwords

contains the libsecret API functions