The home interface
home interface allows access to non-hidden files owned by the user in the user’s home ($HOME) directory where a user normally stores their personal files and documents.
The majority of snaps use strict confinement and do not have arbitrary access a system’s resources, including file and directories in the /home directory. Without this access, home will not be visible in file requesters, or as a destination from within the snap application.
To check whether a snap can connect to $HOME, use the snap connections command:
$ snap connections <snap-name> Interface Plug Slot Notes home <snap-name>:home - -
The above output shows that
<snap-name> does provide a home interface (in the Plug column), but that it’s not connected to any slot (denoted by the
- in the slot column).
Use the snap connect command to connect an interface:
$ snap connect <snap-name>:home :home
:home slot, with no <snap-name> before the colon (
:) is equivalent to directing the plug to connect to the system, which in this case is the $HOME directory.
A snap developer can request permission to have the
home interface connected automatically. In this case, non-hidden files and directories will be accessible from that snap without any further configuration being necessary.
Requires snapd version 2.33+.
- yes on traditional distributions
- no on all other systems, including Ubuntu Core
optional, when set to ‘all’, also allows reading non-hidden files in the home directories of all users as traditional file permissions allow.
When set to ‘all’ this plug becomes non-autoconnect.
Interface source code
Last updated 5 months ago.