flatpak-ps(1) — Linux manual page

FLATPAK PS(1)                   flatpak ps                  FLATPAK PS(1)

NAME         top

       flatpak-ps - Enumerate running instances

SYNOPSIS         top

       flatpak ps [OPTION...]

DESCRIPTION         top

       Lists useful information about running Flatpak instances.

       To see full details of a running instance, you can open the file
       /run/user/$UID/.flatpak/$INSTANCE/info, where $INSTANCE is the
       instance ID reported by flatpak ps.

OPTIONS         top

       The following options are understood:

       -h, --help
           Show help options and exit.

       -v, --verbose
           Print debug information during command processing.

       --ostree-verbose
           Print OSTree debug information during command processing.

       --columns=FIELD,...
           Specify what information to show about each instance. You can
           list multiple fields, or use this option multiple times.

           Append :s[tart], :m[iddle], :e[nd] or :f[ull] to column names
           to change ellipsization.

FIELDS         top

       The following fields are understood by the --columns option:

       instance
           Show the instance ID

       application
           Show the application ID

       arch
           Show the architecture

       branch
           Show the application branch

       commit
           Show the application commit

       runtime
           Show the runtime ID

       runtime-branch
           Show the runtime branch

       runtime-commit
           Show the runtime commit

       pid
           Show the PID of the wrapper process

       child-pid
           Show the PID of the sandbox process

       active
           Show whether the app is active (i.e. has an active window)

       background
           Show whether the app is in the background (with no open
           windows)

       all
           Show all columns

       help
           Show the list of available columns

       Note that field names can be abbreviated to a unique prefix.

EXAMPLES         top

       $ flatpak ps --columns=application,pid,runtime,runtime-branch

SEE ALSO         top

       flatpak(1), flatpak-run(1)

COLOPHON         top

       This page is part of the flatpak (a tool for building and
       distributing desktop applications on Linux) project.  Information
       about the project can be found at ⟨http://flatpak.org/⟩.  It is
       not known how to report bugs for this man page; if you know,
       please send a mail to man-pages@man7.org.  This page was obtained
       from the project's upstream Git repository
       ⟨https://github.com/flatpak/flatpak⟩ on 2025-08-11.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2025-08-06.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

flatpak                                                     FLATPAK PS(1)

Pages that refer to this page: flatpak-enter(1),  flatpak-kill(1)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.