---
name: "flatpak-build-bundle"
section: "1"
platform: "linux"
package: "flatpak"
version: "1:1.18.4-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/flatpak-build-bundle"
---

# flatpak-build-bundle(1)

Create a single-file bundle from a local repository

## NAME

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

## SYNOPSIS

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

## DESCRIPTION

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

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.

- **--oci-layer-compress=gzip\|zstd**

  Choose how to compress the layers in OCI images. gzip (the default) is universally supported, but zstd compresses faster and results in smaller images. As of 2023, zstd support is present in most major registries.

- **-v**, **--verbose**

  Print debug information during command processing.

- **--ostree-verbose**

  Print OSTree debug information during command processing.

## EXAMPLES

**$ 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

[**ostree**(1)](/ostree/1.md), [**flatpak**(1)](/flatpak/1.md), [**flatpak-build-init**(1)](/flatpak-build-init/1.md), [**flatpak-build**(1)](/flatpak-build/1.md), [**flatpak-build-finish**(1)](/flatpak-build-finish/1.md), [**flatpak-build-import-bundle**(1)](/flatpak-build-import-bundle/1.md), [**flatpak-build-update-repo**(1)](/flatpak-build-update-repo/1.md)