Introduction to libsoup3

The libsoup3 is a HTTP client/server library for GNOME. It uses GObject and the GLib main loop to integrate with GNOME applications and it also has an asynchronous API for use in threaded applications.

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

Package Information

libsoup3 Dependencies


glib-networking-2.78.0, libpsl-0.21.5, libxml2-2.12.5, nghttp2-1.59.0, and SQLite-3.45.1



Apache-2.4.58 (required to run the test suite), Brotli-1.1.0, cURL-8.6.0 (required to run the test suite), Gi-DocGen-2023.3, MIT Kerberos V5-1.21.2 (required to run the test suite), PHP-8.3.3 compiled with XMLRPC-EPI support (only used for the XMLRPC regression tests), Samba-4.19.5 (ntlm_auth is required to run the test suite), sysprof, and wstest

Installation of libsoup3

Fix the installation path of API documentation:

sed 's/apiversion/soup_version/' -i docs/reference/

Install libsoup3 by running the following commands:

mkdir build &&
cd    build &&

meson setup --prefix=/usr          \
            --buildtype=release    \
            -Dvapi=enabled         \
            -Dgssapi=disabled      \
            -Dsysprof=disabled     \
            --wrap-mode=nofallback \
            ..                     &&

To test the results, issue: ninja test.

Now, as the root user:

ninja install

Command Explanations

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

--wrap-mode=nofallback: This switch prevents meson from using subproject fallbacks for any dependency declarations in the build files, stopping it downloading any optional dependency which is not installed on the system.

-Dvapi=disabled: Use this if you have not installed Vala, e.g. because you are not building GNOME.

-Ddocs=enabled: If Gi-DocGen-2023.3 is installed, the API documentation will be built and installed no matter if this option is used or not. This option causes the meson command to fail if Gi-DocGen-2023.3 is not installed.

-Dgssapi=disabled: libsoup3 defaults to building with GSSAPI support, which requires Kerberos (as does the test suite).

-Dsysprof=disabled: libsoup3 will automatically download a git version of sysprof if git is available or use the installed version if it is present on the system. If you need profiling, remove this option.


Installed Programs: None
Installed Libraries:
Installed Directories: /usr/include/libsoup-3.0, /usr/share/doc/libsoup-3.4.4 (only installed if gi-docgen is available)

Short Descriptions

provides functions for asynchronous HTTP connections