This document explains how to use swupd search to find and add bundles in Clear Linux* OS.


This guide assumes you:

How do I search for a bundle?

Use swupd search to locate the bundle where the application binary exists.

Example: Kata* Containers

Containers have revolutionized the way we manage cloud infrastructure. Traditional containers often share the same OS kernel, which raises security concerns. Instead, with Kata Containers, each container has its own kernel instance and runs on its own Virtual Machine. Whether you’re running 3 or 300 nodes on your cluster, Kata Containers provide a lightweight, fast, and secure option for app/container management.

In Clear Linux OS, you only need to add one bundle to use Kata Containers: containers-virt. Also, check out our tutorial: Install Kata Containers*.

We need to find kata containers in a bundle. How do we search for it?

  1. Enter swupd search, followed by ‘kata’ as the search term:

    sudo swupd search kata


    swupd search downloads Clear Linux OS manifest data and searches for matching paths. Enter only one term, or hyphenated term, per search. Use the command man swupd to learn more.

  2. Alternatively, if you want to search binaries only, add the -b flag:

    sudo swupd search -b kata


    -b flag, or –binary, means: Restrict search to program binary paths. Omit this flag if you want a larger scope of search results.

    Only the base bundle is returned. In Clear Linux OS, bundles can contain other bundles via includes. For more details, see Bundle Definition Files and its subdirectory bundles.

    If your search does not produce results on a specific term when using the -b flag, abbreviate the search term. For example, if you search for kubernetes and it does not show results, instead abbreviate the term to kube to show results.

  3. Optionally, you can review our bundles or individual packages

  4. Using sudo swupd search -b kata shows a match for our use case.

    Bundle containers-virt    (834 MB to install)


    If the bundle is already installed, [installed] appears in search results. If this doesn’t apppear, the bundle needs to be installed.

  5. Add the bundle containers-virt:

    sudo swupd bundle-add containers-virt


    To add multiple bundles simply add a space followed by the bundle name.

  6. When prompted, enter your password.

  7. Upon successful installation, your console should show similar data:

    Downloading packs...
    Extracting containers-virt pack for version 24430
    Extracting kernel-container pack for version 24430
    Starting download of remaining update content. This may take a while...
    Finishing download of update content...
    Installing bundle(s) files...
    Calling post-update helper scripts.
    Successfully installed 1 bundle