flatpak-update man page

flatpak-update — Update an application or runtime


flatpak update [OPTION...] [REF...]


Updates applications and runtimes. REF is a reference to the application or runtime to install. If no REF is given, everything is updated.

Each REF arguments is a full or partial indentifier in the flatpak ref format, which looks like "(app|runtime)/ID/ARCH/BRANCH". All elements except ID are optional and can be left out, including the slashes, so most of the time you need only specify ID. Any part left out will be matched against what is installed, and if there are multiple matches an error message will list the alternatives.

By default this looks for both apps and runtime with the given REF in the specified REMOTE, but you can limit this by using the --app or --runtime option, or by supplying the initial element in the REF.

Normally, this command updates the application to the tip of its branch. But it is possible to check out another commit, with the --commit option.

Note that updating a runtime is different from installing a different branch, and runtime updates are expected to keep strict compatibility. If an application update does cause a problem, it is possible to go back to the previous version, with the --commit option.

Unless overridden with the --user option, this command updates a system-wide installation.


The following options are understood:

-h, --help
Show help options and exit.
Update a per-user installation.
Update a system-wide installation.
The architecture to update for.
Install only a subpath of the ref. This is mainly used to install a subset of locales. This can be added multiple times to install multiple subpaths. If this is not specified the subpaths specified at install time are reused.
Update to this commit, instead of the tip of the branch.
Download the latest version, but don't deploy it.
Don't download the latest version, deploy it whatever is locally available.
Don't download related extensions, such as the locale data.
Don't update or install runtime dependencies when installing.
Only look for an app with the given name.
Update appstream for the remote.
Only look for an runtime with the given name.
-v, --verbose
Print debug information during command processing.
Print OSTree debug information during command processing.
Print version information and exit.


$ flatpak --user update org.gnome.GEdit

See Also

flatpak(1), flatpak-install(1), flatpak-list(1)

Referenced By

flatpak(1), flatpak-info(1), flatpak-install(1), flatpak-list(1).

Explore man page connections for flatpak-update(1).