man7.org > Linux > man-pages

Linux/UNIX system programming training

flatpak-build-bundle(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | COLOPHON 

FLATPAK BUILD-BUNDL(1)     flatpak build-bundle    FLATPAK BUILD-BUNDL(1)

NAME         top

       flatpak-build-bundle - Create a single-file bundle from a local
       repository

SYNOPSIS         top


       flatpak build-bundle [OPTION...] LOCATION FILENAME NAME [BRANCH]

DESCRIPTION         top

       Creates a single-file named FILENAME for the application (or
       runtime) named NAME in the repository at LOCATION. If a BRANCH is
       specified, this branch of the application is used.

       The collection ID set on the repository at LOCATION (if set) will
       be used for the bundle.

       Unless --oci is used, the format of the bundle file is that of an
       ostree static delta (against an empty base) with some flatpak
       specific metadata for the application icons and appdata.

OPTIONS         top

       The following options are understood:

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

       --runtime
           Export a runtime instead of an application.

       --arch=ARCH
           The arch to create a bundle for. See flatpak
           --supported-arches for architectures supported by the host.

       --repo-url=URL
           The URL for the repository from which the application can be
           updated. Installing the bundle will automatically configure a
           remote for this URL.

       --runtime-repo=URL
           The URL for a .flatpakrepo file that contains the information
           about the repository that supplies the runtimes required by
           the app.

       --gpg-keys=FILE
           Add the GPG key from FILE (use - for stdin).

       --gpg-homedir=PATH
           GPG Homedir to use when looking for keyrings.

       --from-commit=COMMIT
           The OSTree commit to create a delta bundle from.

       --oci
           Export to an OCI image instead of a Flatpak bundle.

       -v, --verbose
           Print debug information during command processing.

       --ostree-verbose
           Print OSTree debug information during command processing.

EXAMPLES         top

       $ flatpak build-bundle /var/lib/flatpak/repo
       gnome-calculator.flatpak org.gnome.Calculator stable

       $ flatpak build-bundle ~/.local/share/flatpak/repo
       gnome-calculator.flatpak org.gnome.Calculator stable

SEE ALSO         top

       ostree(1), flatpak(1), flatpak-build-init(1), flatpak-build(1),
       flatpak-build-finish(1), flatpak-build-import-bundle(1),
       flatpak-build-update-repo(1)

COLOPHON         top

       This page is part of the flatpak (a tool for building and
       distributing desktop applications on Linux) project.  Information
       about the project can be found at ⟨http://flatpak.org/⟩.  It is
       not known how to report bugs for this man page; if you know,
       please send a mail to man-pages@man7.org.  This page was obtained
       from the project's upstream Git repository
       ⟨https://github.com/flatpak/flatpak⟩ on 2025-08-11.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2025-08-06.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

flatpak                                            FLATPAK BUILD-BUNDL(1)

Pages that refer to this page: flatpak(1),  flatpak-build-import-bundle(1),  flatpak-install(1)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI