flatpak-mask(1)

flatpak-mask1

Mask out updates and automatic installation

Usage

flatpak mask [OPTION ...] PATTERN ...

Overview

Flatpak maintains a list of patterns that define which refs are masked. A masked ref will never be updated or automatically installed (for example a masked extension marked auto-download will not be downloaded). You can still manually install such refs, but once they are installed the version will be pinned.

The patterns are just a partial ref, with the * character matching anything within that part of the ref. Here are some example patterns:

org.some.App
org.some.App//unstable
app/org.domain.*
org.some.App/arm

To list the current set of masks, run this command without any patterns.

Options

The following options are understood:

-h, --help

Show help options and exit.

--remove

Instead of adding the patterns, remove matching patterns.

-u, --user

Mask refs in a per-user installation.

--system

Mask refs in the default system-wide installation.

--installation=NAME

Mask refs in a system-wide installation specified by NAME among those defined in /etc/flatpak/installations.d/. Using --installation=default is equivalent to using --system.

-v, --verbose

Print debug information during command processing.

Examples

$ flatpak mask

$ flatpak mask org.broken.App

$ flatpak mask --remove org.broken.App

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

-u since Debian 12 (Bookworm).

From flatpak 1:1.18.4-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.