Browse Tools Top 100
FLATPAK FLATPAKREPO
File conversion

Convert FLATPAK to FLATPAKREPO

Verified by Adam B.· reviewed by FE Editorial ·updated Aug 9, 2026
QUICK ANSWER
Is it possible to convert FLATPAK to FLATPAKREPO?
Yes - FLATPAK converts to FLATPAKREPO.

A .flatpak is a one-off app bundle, while a .flatpakrepo is a small INI file that describes a hosted repository. Use flatpak build-import-bundle to load the bundle into a repo, flatpak build-update-repo to finalize it, then hand-write the .flatpakrepo pointing at the repo's URL and GPG key.

On this page

Tested on macOS, Windows & Linux
Last verified Sep 2026

More free converters

HEIC, PNG, WEBP, MP3 and more - every tool here is free.

Open the toolbox

Why convert FLATPAK to FLATPAKREPO?

Bundles are handy for sending one app as a single file, but they cannot deliver updates; a repository can. Publishing a .flatpakrepo lets users run flatpak remote-add --from yourrepo.flatpakrepo and then install and update your app normally. The .flatpakrepo itself does not contain the app - it just references the repository you built from the bundle.

How to convert FLATPAK to FLATPAKREPO

flatpak build-import-bundle + build-update-repo

Run flatpak build-import-bundle ~/myrepo app.flatpak to add the app to a local OSTree repo, then flatpak build-update-repo ~/myrepo to generate the summary. Add --gpg-sign=KEYID to both to sign it.

Host the repo and hand-write the .flatpakrepo

Serve ~/myrepo over HTTP(S), then create a file with a [Flatpak Repo] section containing Url=, Title=, and a base64 GPGKey= (from gpg --export KEYID | base64 -w0). Save it as myrepo.flatpakrepo.

flatpak remote-add --from (verify it)

Test the result with flatpak remote-add --from myrepo.flatpakrepo, which reads the URL and key from the file and registers the remote.

About these formats

.FLATPAK Linux Flatpak Application Bundle

A .flatpak file is a Flatpak single-file bundle: one Linux application or runtime packaged into a standalone file for direct download, sharing on removable media, or sending by email. Open…

Open .FLATPAK details →
.FLATPAKREPO FLATPAKREPO File

A .FLATPAKREPO file is a data file used by specific software.

Open .FLATPAKREPO details →

Quality & what to watch

  • A .flatpakrepo contains no application data - if the hosted repo goes offline, the file is useless.
  • Skipping build-update-repo leaves the summary stale, so clients cannot install from the repo over HTTP.
  • The GPGKey line must be the base64-encoded public key on a single line, or verification will fail.

Frequently asked questions

Does a .flatpakrepo file hold the app itself?
No. It only stores the repository URL, title, and GPG key; the app lives in the hosted OSTree repo.
Do I need a GPG key?
It is strongly recommended. Sign the bundle import and repo update with --gpg-sign, then embed the base64 key in the .flatpakrepo.
Why convert a bundle to a repo at all?
Bundles cannot push updates. A repository referenced by a .flatpakrepo lets users receive future versions with flatpak update.
Where can I place a .flatpakrepo to preconfigure a remote?
System-wide, drop it in /etc/flatpak/remotes.d/ or /usr/share/flatpak/remotes.d/ with the .flatpakrepo extension.