'\" t
.\"     Title: gnome-software
.\"    Author: Richard Hughes <richard@hughsie.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 06/26/2026
.\"    Manual: User Commands
.\"    Source: GNOME
.\"  Language: English
.\"
.TH "GNOME\-SOFTWARE" "1" "" "GNOME" "User Commands"
.\" -----------------------------------------------------------------
.\" * 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"
gnome-software \- Install and update apps
.SH "SYNOPSIS"
.HP \w'\fBgnome\-software\fR\ 'u
\fBgnome\-software\fR [OPTION...]
.SH "DESCRIPTION"
.PP
\fBgnome\-software\fR
allows you to add and remove apps and update your system\&.
.SH "OPTIONS"
.PP
\fB\-\-mode\fR=\fIMODE\fR
.RS 4
Start gnome\-software in the given mode\&.
\fIMODE\fR
can be
updates,
updated,
installed
or
overview\&. The default mode is
overview\&.
.RE
.PP
\fB\-\-search\fR=\fISEARCH\fR
.RS 4
Search for apps\&.
.RE
.PP
\fB\-\-details\fR=\fIID\fR
.RS 4
Show app details (using app ID)\&.
.RE
.PP
\fB\-\-details\-pkg\fR=\fIPKGNAME\fR
.RS 4
Show app details (using package name)\&.
.RE
.PP
\fB\-\-install\fR=\fIID\fR
.RS 4
Install the app (using app ID)\&.
.RE
.PP
\fB\-\-uninstall\fR=\fIID\fR
.RS 4
Uninstall the app (using app ID)\&.
.RE
.PP
\fB\-\-local\-filename\fR=\fIFILENAME\fR
.RS 4
Open a local package file\&.
.RE
.PP
\fB\-\-interaction\fR=\fIINTERACTION\fR
.RS 4
The kind of interaction expected for this action: either
none,
notify, or
full\&.
.RE
.PP
\fB\-\-show\-metainfo\fR=\fIFILENAME\fR
.RS 4
Show a local metainfo or appdata file\&.
.RE
.PP
\fB\-\-verbose\fR
.RS 4
Enable verbose debugging output (from the running instance, if already running)\&.
.RE
.PP
\fB\-\-autoupdate\fR
.RS 4
Install any pending updates in the background\&.
.RE
.PP
\fB\-\-prefs\fR
.RS 4
Show preferences\&.
.RE
.PP
\fB\-\-quit\fR
.RS 4
Quit the running instance\&.
.RE
.PP
\fB\-\-prefer\-local\fR
.RS 4
Prefer local file sources to AppStream\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Print version and exit\&.
.RE
.PP
\fB\-?\fR, \fB\-\-help\fR
.RS 4
Display help and exit\&.
.RE
.PP
Other standard GNOME options not listed here are also supported\&.
.SH "BUGS"
.PP
The bug tracker can be reached by visiting the website
\m[blue]\fB\%https://gitlab.gnome.org/GNOME/gnome-software/issues\fR\m[]\&.
.SH "AUTHOR"
.PP
This manual page was written by Richard Hughes
<richard@hughsie\&.com>\&.