'\" t
.\"     Title: flatpak installation
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/16/2023
.\"    Manual: flatpak installation
.\"    Source: flatpak
.\"  Language: English
.\"
.TH "FLATPAK INSTALLATION" "5" "" "flatpak" "flatpak installation"
.\" -----------------------------------------------------------------
.\" * 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-installation \- Configuration for an installation location
.SH "DESCRIPTION"
.PP
flatpak can operate in system\-wide or per\-user mode\&. The system\-wide data is located in
$prefix/var/lib/flatpak/, and the per\-user data is in
$HOME/\&.local/share/flatpak/\&.
.PP
In addition to the default installation locations, more system\-wide installations can be defined via configuration files
/etc/flatpak/installations\&.d/, which must have the \&.conf extension and follow the format described below\&.
.SH "FILE FORMAT"
.PP
The installation config file format is using the same \&.ini file format that is used for systemd unit files or application \&.desktop files\&.
.SS "[Installation \&...]"
.PP
All the configuration for the the installation location with name NAME is contained in the [Installation "NAME"] group\&.
.PP
The following keys are recognized:
.PP
\fBPath\fR (string)
.RS 4
The path for this installation\&. This key is mandatory\&.
.RE
.PP
\fBDisplayName\fR (string)
.RS 4
The name to use when showing this installation in the UI\&.
.RE
.PP
\fBPriority\fR (integer)
.RS 4
A priority for this installation\&.
.RE
.PP
\fBStorageType\fR (string)
.RS 4
The type of storage used for this installation\&. Possible values include: network, mmc, sdcard, harddisk\&.
.RE
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
[Installation "extra"]
Path=/location/of/sdcard
DisplayName=Extra Installation
StorageType=sdcard
.fi
.if n \{\
.RE
.\}