'\" t
.\"     Title: flatpak history
.\"    Author: Matthias Clasen <mclasen@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 04/17/2024
.\"    Manual: flatpak history
.\"    Source: flatpak
.\"  Language: English
.\"
.TH "FLATPAK HISTORY" "1" "" "flatpak" "flatpak history"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
flatpak-history \- Show history
.SH "SYNOPSIS"
.HP \w'\fBflatpak\ history\fR\ 'u
\fBflatpak history\fR [OPTION...]
.SH "DESCRIPTION"
.PP
Shows changes to the flatpak installations on the system\&. This includes installs, updates and removals of applications and runtimes\&.
.PP
By default, both per\-user and system\-wide installations are shown\&. Use the
\fB\-\-user\fR,
\fB\-\-installation\fR
or
\fB\-\-system\fR
options to change this\&.
.PP
The information for the history command is taken from the systemd journal, and can also be accessed using e\&.g\&.
\fBjournalctl MESSAGE_ID=c7b39b1e006b464599465e105b361485\fR
.SH "OPTIONS"
.PP
The following options are understood:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Show help options and exit\&.
.RE
.PP
\fB\-u\fR, \fB\-\-user\fR
.RS 4
Show changes to the user installation\&.
.RE
.PP
\fB\-\-system\fR
.RS 4
Show changes to the default system\-wide installation\&.
.RE
.PP
\fB\-\-installation=NAME\fR
.RS 4
Show changes to the installation specified by
NAME
among those defined in
/etc/flatpak/installations\&.d/\&. Using
\fB\-\-installation=default\fR
is equivalent to using
\fB\-\-system\fR\&.
.RE
.PP
\fB\-\-since=TIME\fR
.RS 4
Only show changes that are newer than the time specified by
TIME\&.
.sp
TIME
can be either an absolute time in a format like YYYY\-MM\-DD HH:MM:SS, or a relative time like "2h", "7days", "4days 2hours"\&.
.RE
.PP
\fB\-\-until=TIME\fR
.RS 4
Only show changes that are older than the time specified by
TIME\&.
.RE
.PP
\fB\-\-reverse\fR
.RS 4
Show newest entries first\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
Print debug information during command processing\&.
.RE
.PP
\fB\-\-ostree\-verbose\fR
.RS 4
Print OSTree debug information during command processing\&.
.RE
.PP
\fB\-\-columns=FIELD,\&...\fR
.RS 4
Specify what information to show about each ref\&. You can list multiple fields, or use this option multiple times\&.
.sp
Append :s[tart], :m[iddle], :e[nd] or :f[ull] to column names to change ellipsization\&.
.RE
.SH "FIELDS"
.PP
The following fields are understood by the
\fB\-\-columns\fR
option:
.PP
time
.RS 4
Show when the change happened
.RE
.PP
change
.RS 4
Show the kind of change
.RE
.PP
ref
.RS 4
Show the ref
.RE
.PP
application
.RS 4
Show the application/runtime ID
.RE
.PP
arch
.RS 4
Show the architecture
.RE
.PP
branch
.RS 4
Show the branch
.RE
.PP
installation
.RS 4
Show the affected installation\&.
.sp
This will be either the ID of a Flatpak installation, or the path to a temporary OSTree repository\&.
.RE
.PP
remote
.RS 4
Show the remote that is used\&.
.sp
This will be either the name of a configured remote, or the path to a temporary OSTree repository\&.
.RE
.PP
old\-commit
.RS 4
Show the previous commit\&. For pulls, this is the previous HEAD of the branch\&. For deploys, it is the previously active commit
.RE
.PP
commit
.RS 4
Show the current commit\&. For pulls, this is the HEAD of the branch\&. For deploys, it is the active commit
.RE
.PP
url
.RS 4
Show the remote url
.RE
.PP
user
.RS 4
Show the user doing the change\&.
.sp
If this is the system helper operating as root, also show which user triggered the change\&.
.RE
.PP
tool
.RS 4
Show the tool that was used\&.
.sp
If this is the system helper, also show which tool was used to triggered the change\&.
.RE
.PP
all
.RS 4
Show all columns
.RE
.PP
help
.RS 4
Show the list of available columns
.RE
.PP
Note that field names can be abbreviated to a unique prefix\&.
.SH "SEE ALSO"
.PP
\fBflatpak\fR(1),
\fBjournalctl\fR(1)