'\" t .\" Title: flatpak install .\" Author: Alexander Larsson .\" Generator: DocBook XSL Stylesheets v1.78.1 .\" Date: 03/01/2018 .\" Manual: flatpak install .\" Source: flatpak .\" Language: English .\" .TH "FLATPAK INSTALL" "1" "" "flatpak" "flatpak install" .\" ----------------------------------------------------------------- .\" * 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-install \- Install an application or runtime .SH "SYNOPSIS" .PP Install from a configured remote: .HP \w'\fBflatpak\ install\fR\ 'u \fBflatpak install\fR [OPTION...] REMOTE\-NAME REF... .PP Install from a \&.flatpakref file: .HP \w'\fBflatpak\ install\fR\ 'u \fBflatpak install\fR [OPTION...] [\-\-from] LOCATION .PP Install from a \&.flatpak bundle: .HP \w'\fBflatpak\ install\fR\ 'u \fBflatpak install\fR [OPTION...] [\-\-bundle] FILENAME .PP Install from an OCI registry: .HP \w'\fBflatpak\ install\fR\ 'u \fBflatpak install\fR [OPTION...] \-\-oci LOCATION [TAG] .SH "DESCRIPTION" .PP Installs an application or runtime\&. The primary way to install is to specify a [REMOTE] name as the source and one ore more [REF]s to specify the application or runtime to install\&. .PP Each REF argument 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 in the remote, and if there are multiple matches an error message will list the alternatives\&. .PP By default this looks for both apps and runtime with the given REF in the specified REMOTE, but you can limit this by using the \-\-app or \-\-runtime option, or by supplying the initial element in the REF\&. .PP The alternative form of the command ([\-\-from], [\-\-bundle] or [\-\-oci]) allows you to install directly from a source such as a \&.flatpak single\-file bundle, a \&.flatpakref app description or an OCI registry\&. The options are optional if the first argument have the right extension\&. .PP Note that flatpak allows one to have multiple branches of an application and runtimes installed and used at the same time\&. However, only version of an application one can be current, meaning its exported files (for instance desktop files and icons) are visible to the host\&. The last installed version is made current by default, but you can manually change with make\-current\&. .PP Unless overridden with the \-\-user or the \-\-installation option, this command installs the application or runtime in 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\-\-bundle\fR .RS 4 Assume LOCATION is a \&.flatpak single\-bundle file\&. This is optional if the arguments ends with \&.flatpak\&. .RE .PP \fB\-\-from\fR .RS 4 Assume LOCATION is a \&.flatpakref file containing the details of the app to be installed\&. This is optional if the arguments ends with \&.flatpakref\&. .RE .PP \fB\-\-oci\fR .RS 4 Install from a oci registry with a given uri and optionally a tag (defaults to latest)\&. .RE .PP \fB\-\-user\fR .RS 4 Install the application or runtime in a per\-user installation\&. .RE .PP \fB\-\-system\fR .RS 4 Install the application or runtime in the default system\-wide installation\&. .RE .PP \fB\-\-installation=NAME\fR .RS 4 Install the application or runtime in 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 default architecture to install for, if not given explicitly in the REF\&. .RE .PP \fB\-\-subpath=PATH\fR .RS 4 Install only a subpath of the ref\&. This is mainly used to install a subset of locales\&. This can be added multiple times to install multiple subpaths\&., .RE .PP \fB\-\-no\-deploy\fR .RS 4 Download the latest version, but don\*(Aqt deploy it\&. .RE .PP \fB\-\-no\-pull\fR .RS 4 Don\*(Aqt download the latest version, deploy whatever is locally available\&. .RE .PP \fB\-\-no\-related\fR .RS 4 Don\*(Aqt download related extensions, such as the locale data\&. .RE .PP \fB\-\-no\-deps\fR .RS 4 Don\*(Aqt verify runtime dependencies when installing\&. .RE .PP \fB\-\-app\fR .RS 4 Assume that all REFs are apps if not explicitly specified\&. .RE .PP \fB\-\-runtime\fR .RS 4 Assume that all REFs are runtimes if not explicitly specified\&. .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 install gnome org\&.gnome\&.gedit2\fR .PP \fB$ flatpak \-\-installation=default install gnome org\&.gnome\&.gedit2\fR .PP \fB$ flatpak \-\-user install gnome org\&.gnome\&.gedit//3\&.22\fR .PP \fB$ flatpak \-\-user install https://sdk\&.gnome\&.org/gedit\&.flatpakref\fR .SH "SEE ALSO" .PP \fBflatpak\fR(1), \fBflatpak-update\fR(1), \fBflatpak-list\fR(1), \fBflatpak-build-bundle\fR(1), \fBflatpak-flatpakref\fR(1)