SYNOPSIS
snap [OPTIONS]DESCRIPTION
The snap tool interacts with the snapd daemon to control the snappy software platform.
OPTIONS
- --version
- print the version and exit
- -h, --help
- Show this help message
COMMANDS
abort
Abort a pending changeThe abort command attempts to abort a change that still has pending tasks.
- -h, --help
- Show this help message
ack
Adds an assertion to the systemThe ack command tries to add an assertion to the system assertion database.
The assertion may also be a newer revision of a preexisting assertion that it will replace.
To succeed the assertion must be valid, its signature verified with a known public key and the assertion consistent with and its prerequisite in the database.
- -h, --help
- Show this help message
change
List a change's tasksThe change command displays a summary of tasks associated to an individual change.
- -h, --help
- Show this help message
changes
List system changesThe changes command displays a summary of the recent system changes performed.
- -h, --help
- Show this help message
connect
Connects a plug to a slotThe connect command connects a plug to a slot. It may be called in the following ways:
$ snap connect <snap>:<plug> <snap>:<slot>
Connects the specific plug to the specific slot.
$ snap connect <snap>:<plug> <snap>
Connects the specific plug to the only slot in the provided snap that matches the connected interface. If more than one potential slot exists, the command fails.
$ snap connect <plug> <snap>[:<slot>]
Without a name for the snap offering the plug, the plug name is looked at in the gadget snap, the kernel snap, and then the os snap, in that order. The first of these snaps that has a matching plug name is used and the command proceeds as above.
- -h, --help
- Show this help message
disconnect
Disconnects a plug from a slotThe disconnect command disconnects a plug from a slot. It may be called in the following ways:
$ snap disconnect <snap>:<plug> <snap>:<slot>
Disconnects the specific plug from the specific slot.
$ snap disconnect <snap>:<slot>
Disconnects any previously connected plugs from the provided slot.
$ snap disconnect <snap>
Disconnects all plugs from the provided snap.
- -h, --help
- Show this help message
find
Finds packages to installThe find command queries the store for available packages.
- -h, --help
- Show this help message
help
HelpHow help for the snap command.
Usage: snap [OPTIONS] help [help-OPTIONS]
- --man
-
- Generate the manpage
- -h, --help
- Show this help message
install
Install a snap to the systemThe install command installs the named snap in the system.
Usage: snap [OPTIONS] install [install-OPTIONS]
- --channel
-
- Install from this channel instead of the device's default
- --devmode
- Install the snap with non-enforcing security
- -h, --help
- Show this help message
interfaces
Lists interfaces in the systemThe interfaces command lists interfaces available in the system.
By default all slots and plugs, used and offered by all snaps, are displayed.
$ snap interfaces <snap>:<slot or plug>
Lists only the specified slot or plug.
$ snap interfaces <snap>
Lists the slots offered and plugs used by the specified snap.
$ snap interfaces -i=<interface> [<snap>]
Filters the complete output so only plugs and/or slots matching the provided details are listed.
Usage: snap [OPTIONS] interfaces [interfaces-OPTIONS]
- -i
-
- constrain listing to specific interfaces
- -h, --help
- Show this help message
known
Shows known assertions of the provided typeThe known command shows known assertions of the provided type. If header=value pairs are provided after the assertion type, the assertions shown must also have the specified headers matching the provided values.
- -h, --help
- Show this help message
list
List installed snapsThe list command displays a summary of snaps installed in the current system.
- -h, --help
- Show this help message
login
Authenticates on snapd and the storeThe login command authenticates on snapd and the snap store and saves credentials into the ~/.snap/auth.json file. Further communication with snapd will then be made using those credentials.
Login only works for local users in the sudo or admin groups.
An account can be setup at https://login.ubuntu.com
- -h, --help
- Show this help message
logout
Log out of the storeThis command logs the current user out of the store
- -h, --help
- Show this help message
refresh
Refresh a snap in the systemThe refresh command refreshes (updates) the named snap.
Usage: snap [OPTIONS] refresh [refresh-OPTIONS]
- --list
-
- show available snaps for refresh
- --channel
- Refresh to the latest on this channel, and track this channel henceforth
- -h, --help
- Show this help message
remove
Remove a snap from the systemThe remove command removes the named snap from the system.
The snap's data is currently not removed; use purge for that. This behaviour will change before 16.04 is final.
- -h, --help
- Show this help message
try
Try an unpacked snap in the systemThe try command installs an unpacked snap into the system for testing purposes. The unpacked snap content continues to be used even after installation, so non-metadata changes there go live instantly. Metadata changes such as those performed in snap.yaml will require reinstallation to go live.
Usage: snap [OPTIONS] try [try-OPTIONS]
- --devmode
-
- Install in development mode and disable confinement
- -h, --help
-
Show this help message