'\" t
.\"     Title: flatpak uninstall
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 03/01/2018
.\"    Manual: dxg-app uninstall
.\"    Source: flatpak
.\"  Language: English
.\"
.TH "FLATPAK UNINSTALL" "1" "" "flatpak" "dxg-app uninstall"
.\" -----------------------------------------------------------------
.\" * 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-uninstall \- Uninstall an application or runtime
.SH "SYNOPSIS"
.HP \w'\fBflatpak\ uninstall\fR\ 'u
\fBflatpak uninstall\fR [OPTION...] [REF...]
.SH "DESCRIPTION"
.PP
Uninstalls an application or runtime\&.
REF
is a reference to the application or runtime to install\&. If no
REF
is given, everything is updated\&.
.PP
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\&.
.PP
By default this looks for both installed apps and runtime with the given
NAME, but you can limit this by using the \-\-app or \-\-runtime option\&.
.PP
Normally, this command removes the ref for this application/runtime from the local OSTree repository and purges and objects that are no longer needed to free up disk space\&. If the same application is later reinstalled, the objects will be pulled from the remote repository again\&. The \-\-keep\-ref option can be used to prevent this\&.
.PP
If all branches of the application/runtime are removed, this command also purges the data directory for the application\&.
.PP
Unless overridden with the \-\-user or the \-\-installation option, this command updates the default system\-wide installation\&.
.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\-\-keep\-ref\fR
.RS 4
Keep the ref for the application and the objects belonging to it in the local repository\&.
.RE
.PP
\fB\-\-user\fR
.RS 4
Updates a per\-user installation\&.
.RE
.PP
\fB\-\-system\fR
.RS 4
Updates the default system\-wide installation\&.
.RE
.PP
\fB\-\-installation=NAME\fR
.RS 4
Updates a system\-wide installation specified by
NAME
among those defined in
/etc/flatpak/installations\&.d\&. Using
\-\-installation=default
is equivalent to using
\-\-system\&.
.RE
.PP
\fB\-\-arch=ARCH\fR
.RS 4
The architecture to uninstall, instead of the architecture of the host system\&.
.RE
.PP
\fB\-\-app\fR
.RS 4
Only look for an app with the given name\&.
.RE
.PP
\fB\-\-runtime\fR
.RS 4
Only look for an runtime with the given name\&.
.RE
.PP
\fB\-\-no\-related\fR
.RS 4
Don\*(Aqt uninstall related extensions, such as the locale data\&.
.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\-\-version\fR
.RS 4
Print version information and exit\&.
.RE
.SH "EXAMPLES"
.PP
\fB$ flatpak \-\-user uninstall org\&.gnome\&.GEdit\fR