Flatpak Builder

What Flatpak Builder is
Flatpak Builder is a Linux tool for building Flatpak applications from source files. It uses a manifest to define an application’s parameters, runtime, modules, and build instructions; module sources can come from file archives or version-control repositories. Builds run inside an SDK with development tools such as compilers and debuggers, and Builder can build dependencies alongside the application and bundle them. A completed build can be installed locally with the --install option or exported to a repository.
During a build, module source code is downloaded and verified. The documentation also describes signing repository commits with GPG and using Builder’s --gpg-sign option. Flatpak applications run in sandboxes, where access to user files, networks, devices, and other host resources must be explicitly granted. Builder is free and open source, with a listed price of $0 and no paid plans or usage limits stated. It is packaged by popular Linux distributions and is available as a Flatpak package on Flathub. The documentation is aimed mainly at application developers and distributors; applications that need elevated privileges, host process access, or kernel modules may not be suitable for Flatpak.
Who it suits
Flatpak Builder is aimed primarily at Linux application developers and distributors who want to build and package Flatpak applications from source. It may not suit applications that require elevated privileges, host process access, or kernel modules.
What it does well
- Builds dependencies alongside the application.
- Verifies module source code during builds.
- Can install builds locally or export repositories.
- Supports command-line packaging and CI/CD integration.
- Flatpak applications use explicit sandbox permissions.
What to know first
- Runs only on Linux.
- Apps needing elevated privileges may not be suitable.
- Host process access requirements may make Flatpak unsuitable.
- Kernel-module requirements may make Flatpak unsuitable.
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| Flatpak Builder | No paid plans or usage limits stated on the pages reviewed | Free |
As docs.flatpak.org lists them, read 4 Oct 2026. The maker's own page has the final word.
Getting started
- Open the Flatpak Builder documentation website.
- Install Flatpak Builder from a Linux distribution package or its Flathub package.
- Prepare a manifest with the application parameters, runtime, modules, sources, and build instructions.
- Build the application in an SDK.
- Install the build locally with `--install` or export it to a repository.
Verdict
Flatpak Builder provides a manifest- and SDK-based route to build Flatpak applications, install them locally, or export them to a repository. Its Linux-only scope and sandbox model are important considerations for both developers and distributors.
Questions
How much does Flatpak Builder cost?
Flatpak Builder is free and open source. Its listed plan is free.
Which platform does it support?
Flatpak Builder runs on Linux.
What can it produce?
It can produce a Flatpak application or an OSTree repository.
Can it build dependencies and install an application locally?
Yes. It can build dependencies alongside the app, and a build can be installed locally with `--install`.
How are Flatpak applications isolated?
They run in sandboxes, and access to user files, networks, devices, and other host resources must be granted explicitly.
Who develops Flatpak Builder?
Flatpak is developed by an independent open source community. Listed support channels include mailing lists, a security mailing list, Matrix, and GitHub.
Facts from Flatpak Builder's own pages
- Build environment
- Flatpak applications are built inside an SDK that includes development tools such as compilers and debuggers. · docs.flatpak.org, 4 Oct 2026
- Builds
- It can build application dependencies alongside the app and bundle them into the build. · docs.flatpak.org, 4 Oct 2026
- Distribution
- Flatpak Builder is packaged by popular Linux distributions and is also available as a Flatpak package on Flathub. · docs.flatpak.org, 4 Oct 2026
- Export and install
- Builder can export applications to a repository or install a build locally with the --install option. · docs.flatpak.org, 4 Oct 2026
- Manifests
- Builds use a manifest that specifies application parameters, runtime, modules, and build instructions. · docs.flatpak.org, 4 Oct 2026
- Notable limits
- Flatpak runs only on Linux, and applications that need elevated privileges, host process access, or kernel modules may not be suitable for it. · docs.flatpak.org, 4 Oct 2026
- Project and support channels
- Flatpak is developed by an independent open source community, and its About page lists mailing lists, a security mailing list, Matrix, and GitHub. · flatpak.org, 4 Oct 2026
- Purpose
- Flatpak Builder is the primary tool for building Flatpak applications from source files. · docs.flatpak.org, 4 Oct 2026
- Repository signing
- The documentation recommends signing every repository commit with a GPG signature and describes Builder's --gpg-sign option. · docs.flatpak.org, 4 Oct 2026
- Security model
- Flatpak applications run in sandboxes and access to user files, network, devices, and other host resources must be explicitly granted. · docs.flatpak.org, 4 Oct 2026
- Sources
- A manifest can specify module sources such as file archives or version control repositories. · docs.flatpak.org, 4 Oct 2026
- Source verification
- During a build, source code for each module is downloaded and verified. · docs.flatpak.org, 4 Oct 2026
- Supported audience
- The documentation is primarily intended for application developers and distributors. · docs.flatpak.org, 4 Oct 2026
Where Flatpak Builder stands on Freedom251
- App Installation#7 of 24
- Software Packaging Tools#15 of 29
- Package Managers#80 of 93