Introduction to libsecret

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

This package is known to build and work properly using an LFS 12.1 platform.

Package Information

libsecret Dependencies





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

Optional (Required for the test suite)

D-Bus Python-1.3.2, Gjs-1.78.4, 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.3 installed and wish to build the API documentation for this package, issue:

sed "s/api_version_major/'0.21.3'/"            \
    -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.3 installed. If you have Gi-DocGen-2023.3 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.39 and DocBook packages.

-Dcrypto=gnutls, disabled: Use this switch if you want to use GnuTLS-3.8.3 for cryptography or if either GnuTLS-3.8.3 or libgcrypt-1.10.3 is not installed.


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

Short Descriptions


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

contains the libsecret API functions