1snap(8)                     System Manager's Manual                    snap(8)
2
3
4

NAME

6       snap - Tool to interact with snaps
7

SYNOPSIS

9       snap [OPTIONS]
10

DESCRIPTION

12       The snap command lets you install, configure, refresh and remove snaps.
13       Snaps are packages that work across many different Linux distributions,
14       enabling  secure  delivery  and operation of the latest apps and utili‐
15       ties.
16

OPTIONS

COMMANDS

19   abort
20       Abort a pending change
21
22       The abort command attempts to abort a change  that  still  has  pending
23       tasks.
24
25       Usage: snap abort [abort-OPTIONS]
26
27       --last Select last change of given type (install, refresh, remove, try,
28              auto-refresh, etc.). A question mark at  the  end  of  the  type
29              means to do nothing (instead of returning an error) if no change
30              of the given type is found. Note the question  mark  could  need
31              protecting from the shell.
32
33   ack
34       Add an assertion to the system
35
36       The ack command tries to add an assertion to the system assertion data‐
37       base.
38
39       The assertion may also be a newer revision of a pre-existing  assertion
40       that it will replace.
41
42       To  succeed  the assertion must be valid, its signature verified with a
43       known public key and the assertion consistent with and its prerequisite
44       in the database.
45
46   alias
47       Set up a manual alias
48
49       The  alias  command  aliases  the  given  snap application to the given
50       alias.
51
52       Once this manual alias is setup the respective application command  can
53       be invoked just using the alias.
54
55       Usage: snap alias [alias-OPTIONS]
56
57       --no-wait
58              Do  not  wait  for  the  operation  to finish but just print the
59              change id.
60
61   aliases
62       List aliases in the system
63
64       The aliases command lists all aliases available in the system and their
65       status.
66
67       $ snap aliases <snap>
68
69       Lists only the aliases defined by the specified snap.
70
71       An alias noted as undefined means it was explicitly enabled or disabled
72       but is not defined in the current revision of the snap, possibly tempo‐
73       rarily  (e.g.   because of a revert). This can cleared with 'snap alias
74       --reset'.
75
76   changes
77       List system changes
78
79       The changes command displays a  summary  of  system  changes  performed
80       recently.
81
82       Usage: snap changes [changes-OPTIONS]
83
84       --abs-time
85              Display  absolute times (in RFC 3339 format). Otherwise, display
86              relative times up to 60 days, then YYYY-MM-DD.
87
88   check-snapshot
89       Check a snapshot
90
91       The check-snapshot command verifies the user, system and  configuration
92       data of the snaps included in the specified snapshot.
93
94       The  check  operation runs the same data integrity verification that is
95       performed when a snapshot is restored.
96
97       By default, this command checks all the data in a  snapshot.   Alterna‐
98       tively,  you can specify the data of which snaps to check, or for which
99       users, or a combination of these.
100
101       If a snap is included in a check-snapshot operation, excluding its sys‐
102       tem  and  configuration  data from the check is not currently possible.
103       This restriction may be lifted in the future.
104
105       Usage: snap check-snapshot [check-snapshot-OPTIONS]
106
107       --no-wait
108              Do not wait for the operation  to  finish  but  just  print  the
109              change id.
110
111       --users
112              Check  data  of  only specific users (comma-separated) (default:
113              all users)
114
115   connect
116       Connect a plug to a slot
117
118       The connect command connects a plug to a slot.  It may be called in the
119       following ways:
120
121       $ snap connect <snap>:<plug> <snap>:<slot>
122
123       Connects the provided plug to the given slot.
124
125       $ snap connect <snap>:<plug> <snap>
126
127       Connects  the  specific plug to the only slot in the provided snap that
128       matches the connected  interface.  If  more  than  one  potential  slot
129       exists, the command fails.
130
131       $ snap connect <snap>:<plug>
132
133       Connects  the  provided  plug  to the slot in the core snap with a name
134       matching the plug name.
135
136       Usage: snap connect [connect-OPTIONS]
137
138       --no-wait
139              Do not wait for the operation  to  finish  but  just  print  the
140              change id.
141
142   connections
143       List interface connections
144
145       The  connections  command  lists connections between plugs and slots in
146       the system.
147
148       Unless <snap> is provided, the listing is for connected plugs and slots
149       for  all  snaps  in  the  system. In this mode, pass --all to also list
150       unconnected plugs and slots.
151
152       $ snap connections <snap>
153
154       Lists connected and unconnected plugs and slots for the specified snap.
155
156       Usage: snap connections [connections-OPTIONS]
157
158       --all  Show connected and unconnected plugs and slots
159
160   create-cohort
161       Create cohort keys for a series of snaps
162
163       The create-cohort command creates a set of cohort keys for a given  set
164       of snaps.
165
166       A  cohort  is  a  view or snapshot of a snap's "channel map" at a given
167       point in time that fixes the set of revisions for the snap given  other
168       constraints  (e.g. channel or architecture). The cohort is then identi‐
169       fied by an opaque per-snap key that works across systems. Installations
170       or  refreshes  of  the  snap using a given cohort key would use a fixed
171       revision for up to 90 days, after which a new set of revisions would be
172       fixed under that same cohort key and a new 90 days window started.
173
174   disable
175       Disable a snap in the system
176
177       The  disable  command disables a snap. The binaries and services of the
178       snap will no longer be available, but all the data is  still  available
179       and the snap can easily be enabled again.
180
181       Usage: snap disable [disable-OPTIONS]
182
183       --no-wait
184              Do  not  wait  for  the  operation  to finish but just print the
185              change id.
186
187   disconnect
188       Disconnect a plug from a slot
189
190       The disconnect command disconnects a plug  from  a  slot.   It  may  be
191       called in the following ways:
192
193       $ snap disconnect <snap>:<plug> <snap>:<slot>
194
195       Disconnects the specific plug from the specific slot.
196
197       $ snap disconnect <snap>:<slot or plug>
198
199       Disconnects  everything  from the provided plug or slot.  The snap name
200       may be omitted for the core snap.
201
202       Usage: snap disconnect [disconnect-OPTIONS]
203
204       --no-wait
205              Do not wait for the operation  to  finish  but  just  print  the
206              change id.
207
208   download
209       Download the given snap
210
211       The download command downloads the given snap and its supporting asser‐
212       tions to the current directory with .snap and .assert file  extensions,
213       respectively.
214
215       Usage: snap download [download-OPTIONS]
216
217       --channel
218              Use this channel instead of stable
219
220       --edge Install from the edge channel
221
222       --beta Install from the beta channel
223
224       --candidate
225              Install from the candidate channel
226
227       --stable
228              Install from the stable channel
229
230       --revision
231              Download  the  given  revision of a snap, to which you must have
232              developer access
233
234       --basename
235              Use this basename for the snap and assertion files (defaults  to
236              <snap>_<revision>)
237
238       --target-directory
239              Download to this directory (defaults to the current directory)
240
241       --cohort
242              Download from the given cohort
243
244   enable
245       Enable a snap in the system
246
247       The enable command enables a snap that was previously disabled.
248
249       Usage: snap enable [enable-OPTIONS]
250
251       --no-wait
252              Do  not  wait  for  the  operation  to finish but just print the
253              change id.
254
255   find
256       Find packages to install
257
258       The find command queries the store for available packages in the stable
259       channel.
260
261       With the --private flag, which requires the user to be logged-in to the
262       store (see 'snap help login'), it instead searches  for  private  snaps
263       that  the  user has developer access to, either directly or through the
264       store's collaboration feature.
265
266       A green check mark (given color and unicode support) after a  publisher
267       name indicates that the publisher has been verified.
268
269       Usage: snap find [find-OPTIONS]
270
271
272       Aliases: search
273
274
275       --private
276              Search private snaps
277
278       --narrow
279              Only search for snaps in “stable”
280
281       --section  [="show-all-sections-please"]  <default:  "no-section-speci‐
282       fied">
283              Restrict the search to a given section
284
285       --color <default: "auto">
286              Use a little bit of color to highlight some things.
287
288       --unicode <default: "auto">
289              Use a little bit of Unicode to improve legibility.
290
291   forget
292       Delete a snapshot
293
294       The forget command deletes  a  snapshot.  This  operation  can  not  be
295       undone.
296
297       A  snapshot  contains  archives  for the user, system and configuration
298       data of each snap included in the snapshot.
299
300       By default, this command forgets all the data in a snapshot.   Alterna‐
301       tively, you can specify the data of which snaps to forget.
302
303       Usage: snap forget [forget-OPTIONS]
304
305       --no-wait
306              Do  not  wait  for  the  operation  to finish but just print the
307              change id.
308
309   get
310       Print configuration options
311
312       The get command prints configuration options for the provided snap.
313
314           $ snap get snap-name username
315           frank
316
317       If multiple option names are provided, a document is returned:
318
319           $ snap get snap-name username password
320           {
321               "username": "frank",
322               "password": "..."
323           }
324
325       Nested values may be retrieved via a dotted path:
326
327           $ snap get snap-name author.name
328           frank
329
330       Usage: snap get [get-OPTIONS]
331
332       -t     Strict typing with nulls and quoted strings
333
334       -d     Always return document, even with single key
335
336       -l     Always return list, even with single key
337
338   help
339       Show help about a command
340
341       The help command displays information about snap commands.
342
343       Usage: snap help [help-OPTIONS]
344
345       --all  Show a short summary of all commands
346
347   info
348       Show detailed information about snaps
349
350       The info command shows detailed information about snaps.
351
352       The snaps can be specified by name or by path;  names  are  looked  for
353       both  in  the  store  and  in the installed snaps; paths can refer to a
354       .snap file, or to a directory that contains an unpacked  snap  suitable
355       for  'snap  try'  (an  example  of  this would be the 'prime' directory
356       snapcraft produces).
357
358       Usage: snap info [info-OPTIONS]
359
360       --color <default: "auto">
361              Use a little bit of color to highlight some things.
362
363       --unicode <default: "auto">
364              Use a little bit of Unicode to improve legibility.
365
366       --abs-time
367              Display absolute times (in RFC 3339 format). Otherwise,  display
368              relative times up to 60 days, then YYYY-MM-DD.
369
370       --verbose
371              Include more details on the snap (expanded notes, base, etc.)
372
373   install
374       Install snaps on the system
375
376       The install command installs the named snaps on the system.
377
378       To  install  multiple  instances of the same snap, append an underscore
379       and a unique identifier (for each instance) to a snap's name.
380
381       With no further options, the snaps are installed  tracking  the  stable
382       channel, with strict security confinement.
383
384       Revision  choice  via  the --revision override requires the the user to
385       have developer access to the  snap,  either  directly  or  through  the
386       store's  collaboration  feature,  and  to  be logged in (see 'snap help
387       login').
388
389       Note a later refresh will typically undo a  revision  override,  taking
390       the snap back to the current revision of the channel it's tracking.
391
392       Use --name to set the instance name when installing from snap file.
393
394       Usage: snap install [install-OPTIONS]
395
396       --color <default: "auto">
397              Use a little bit of color to highlight some things.
398
399       --unicode <default: "auto">
400              Use a little bit of Unicode to improve legibility.
401
402       --no-wait
403              Do  not  wait  for  the  operation  to finish but just print the
404              change id.
405
406       --channel
407              Use this channel instead of stable
408
409       --edge Install from the edge channel
410
411       --beta Install from the beta channel
412
413       --candidate
414              Install from the candidate channel
415
416       --stable
417              Install from the stable channel
418
419       --devmode
420              Put snap in development mode and disable security confinement
421
422       --jailmode
423              Put snap in enforced confinement mode
424
425       --classic
426              Put snap in classic mode and disable security confinement
427
428       --revision
429              Install the given revision of a snap, to  which  you  must  have
430              developer access
431
432       --dangerous
433              Install  the  given  snap file even if there are no pre-acknowl‐
434              edged signatures for it, meaning it was not verified  and  could
435              be dangerous (--devmode implies this)
436
437       --unaliased
438              Install the given snap without enabling its automatic aliases
439
440       --name Install the snap file under the given instance name
441
442       --cohort
443              Install the snap in the given cohort
444
445   interface
446       Show details of snap interfaces
447
448       The interface command shows details of snap interfaces.
449
450       If  no  interface  name  is provided, a list of interface names with at
451       least one connection is shown, or a list of all interfaces if --all  is
452       provided.
453
454       Usage: snap interface [interface-OPTIONS]
455
456       --attrs
457              Show interface attributes
458
459       --all  Include unused interfaces
460
461   known
462       Show known assertions of the provided type
463
464       The  known  command  shows  known  assertions of the provided type.  If
465       header=value pairs are provided after the assertion  type,  the  asser‐
466       tions  shown must also have the specified headers matching the provided
467       values.
468
469       Usage: snap known [known-OPTIONS]
470
471       --remote
472
473   list
474       List installed snaps
475
476       The list command displays a summary of snaps installed in  the  current
477       system.
478
479       A  green check mark (given color and unicode support) after a publisher
480       name indicates that the publisher has been verified.
481
482       Usage: snap list [list-OPTIONS]
483
484       --all  Show all revisions
485
486       --color <default: "auto">
487              Use a little bit of color to highlight some things.
488
489       --unicode <default: "auto">
490              Use a little bit of Unicode to improve legibility.
491
492   login
493       Authenticate to snapd and the store
494
495       The login command authenticates the user to snapd and the  snap  store,
496       and saves credentials into the ~/.snap/auth.json file. Further communi‐
497       cation with snapd will then be made using those credentials.
498
499       It's not necessary to log in to interact with snapd. Doing so, however,
500       enables  purchasing  of  snaps  using  'snap buy', as well as some some
501       developer-oriented features as detailed  in  the  help  for  the  find,
502       install and refresh commands.
503
504       An account can be set up at https://login.ubuntu.com
505
506   logout
507       Log out of snapd and the store
508
509       The logout command logs the current user out of snapd and the store.
510
511   logs
512       Retrieve logs for services
513
514       The  logs  command fetches logs of the given services and displays them
515       in chronological order.
516
517       Usage: snap logs [logs-OPTIONS]
518
519       -n <default: "10">
520              Show only the given number of lines, or 'all'.
521
522       -f     Wait for new lines and print them as they come in.
523
524   model
525       Get the active model for this device
526
527       The model command returns the active model  assertion  information  for
528       this device.
529
530       By  default,  only  the  essential  model identification information is
531       included in the output, but this can be expanded to include all  of  an
532       assertion's non-meta headers.
533
534       The verbose output is presented in a structured, yaml-like format.
535
536       Similarly,  the  active  serial  assertion  can  be used for the output
537       instead of the model assertion.
538
539       Usage: snap model [model-OPTIONS]
540
541       --no-wait
542              Do not wait for the operation  to  finish  but  just  print  the
543              change id.
544
545       --abs-time
546              Display  absolute times (in RFC 3339 format). Otherwise, display
547              relative times up to 60 days, then YYYY-MM-DD.
548
549       --color <default: "auto">
550              Use a little bit of color to highlight some things.
551
552       --unicode <default: "auto">
553              Use a little bit of Unicode to improve legibility.
554
555       --serial
556              Print the serial assertion instead of the model assertion.
557
558       --verbose
559              Print all specific assertion fields.
560
561       --assertion
562              Print the raw assertion.
563
564   okay
565       Acknowledge warnings
566
567       The okay command acknowledges the warnings listed with 'snap warnings'.
568
569       Once acknowledged a warning won't appear again unless it re-occurrs and
570       sufficient time has passed.
571
572   pack
573       Pack the given directory as a snap
574
575       The  pack  command  packs  the  given snap-dir as a snap and writes the
576       result to target-dir. If target-dir is omitted, the result  is  written
577       to  current  directory.  If both source-dir and target-dir are omitted,
578       the pack command packs the current directory.
579
580       The default file name for a snap  can  be  derived  entirely  from  its
581       snap.yaml, but in some situations it's simpler for a script to feed the
582       filename in. In those cases, --filename can be given  to  override  the
583       default.  If this filename is not absolute it will be taken as relative
584       to target-dir.
585
586       When used with --check-skeleton, pack only checks whether snap-dir con‐
587       tains  valid  snap  metadata and raises an error otherwise. Application
588       commands listed in snap metadata file,  but  appearing  with  incorrect
589       permission  bits  result  in  an  error. Commands that are missing from
590       snap-dir are listed in diagnostic messages.
591
592       Usage: snap pack [pack-OPTIONS]
593
594       --check-skeleton
595              Validate snap-dir metadata only
596
597       --filename
598              Output to this filename
599
600   prefer
601       Enable aliases from a snap, disabling any conflicting aliases
602
603       The prefer command enables all aliases of the given snap in  preference
604       to  conflicting  aliases  of other snaps whose aliases will be disabled
605       (or removed, for manual ones).
606
607       Usage: snap prefer [prefer-OPTIONS]
608
609       --no-wait
610              Do not wait for the operation  to  finish  but  just  print  the
611              change id.
612
613   prepare-image
614       Prepare a device image
615
616       The prepare-image command performs some of the steps necessary for cre‐
617       ating device images.
618
619       For core images it is not invoked  directly  but  usually  via  ubuntu-
620       image.
621
622       For preparing classic images it supports a --classic mode
623
624       Usage: snap prepare-image [prepare-image-OPTIONS]
625
626       --classic
627              Enable classic mode to prepare a classic model image
628
629       --arch Specify  an  architecture for snaps for --classic when the model
630              does not
631
632       --channel <default: "stable">
633              The channel to use
634
635       --snap <snap>[=<channel>]
636              Include the given snap from the store or  a  local  file  and/or
637              specify the channel to track for the given snap
638
639   refresh
640       Refresh snaps in the system
641
642       The  refresh  command  updates the specified snaps, or all snaps in the
643       system if none are specified.
644
645       With no further options, the snaps are refreshed to the  current  revi‐
646       sion  of  the  channel  they're  tracking, preserving their confinement
647       options.
648
649       Revision choice via the --revision override requires the  the  user  to
650       have  developer  access  to  the  snap,  either directly or through the
651       store's collaboration feature, and to be  logged  in  (see  'snap  help
652       login').
653
654       Note a later refresh will typically undo a revision override.
655
656       Usage: snap refresh [refresh-OPTIONS]
657
658       --color <default: "auto">
659              Use a little bit of color to highlight some things.
660
661       --unicode <default: "auto">
662              Use a little bit of Unicode to improve legibility.
663
664       --abs-time
665              Display  absolute times (in RFC 3339 format). Otherwise, display
666              relative times up to 60 days, then YYYY-MM-DD.
667
668       --no-wait
669              Do not wait for the operation  to  finish  but  just  print  the
670              change id.
671
672       --channel
673              Use this channel instead of stable
674
675       --edge Install from the edge channel
676
677       --beta Install from the beta channel
678
679       --candidate
680              Install from the candidate channel
681
682       --stable
683              Install from the stable channel
684
685       --devmode
686              Put snap in development mode and disable security confinement
687
688       --jailmode
689              Put snap in enforced confinement mode
690
691       --classic
692              Put snap in classic mode and disable security confinement
693
694       --amend
695              Allow refresh attempt on snap unknown to the store
696
697       --revision
698              Refresh  to the given revision, to which you must have developer
699              access
700
701       --cohort
702              Refresh the snap into the given cohort
703
704       --leave-cohort
705              Refresh the snap out of its cohort
706
707       --list Show the new versions of snaps that would be  updated  with  the
708              next refresh
709
710       --time Show auto refresh information but do not perform a refresh
711
712       --ignore-validation
713              Ignore validation by other snaps blocking the refresh
714
715   remove
716       Remove snaps from the system
717
718       The remove command removes the named snap instance from the system.
719
720       By default all the snap revisions are removed, including their data and
721       the common data directory. When a --revision option is passed only  the
722       specified revision is removed.
723
724       Usage: snap remove [remove-OPTIONS]
725
726       --no-wait
727              Do  not  wait  for  the  operation  to finish but just print the
728              change id.
729
730       --revision
731              Remove only the given revision
732
733       --purge
734              Remove the snap without saving a snapshot of its data
735
736   restart
737       Restart services
738
739       The restart command restarts the given services.
740
741       If the --reload option is given, for  each  service  whose  app  has  a
742       reload command, a reload is performed instead of a restart.
743
744       Usage: snap restart [restart-OPTIONS]
745
746       --no-wait
747              Do  not  wait  for  the  operation  to finish but just print the
748              change id.
749
750       --reload
751              If the service has a reload command, use it instead of  restart‐
752              ing.
753
754   restore
755       Restore a snapshot
756
757       The restore command replaces the current user, system and configuration
758       data of included snaps, with the corresponding data from the  specified
759       snapshot.
760
761       By default, this command restores all the data in a snapshot.  Alterna‐
762       tively, you can specify the data of which  snaps  to  restore,  or  for
763       which users, or a combination of these.
764
765       If  a snap is included in a restore operation, excluding its system and
766       configuration data from the restore is  not  currently  possible.  This
767       restriction may be lifted in the future.
768
769       Usage: snap restore [restore-OPTIONS]
770
771       --no-wait
772              Do  not  wait  for  the  operation  to finish but just print the
773              change id.
774
775       --users
776              Restore data of only specific users (comma-separated)  (default:
777              all users)
778
779   revert
780       Reverts the given snap to the previous state
781
782       The  revert command reverts the given snap to its state before the lat‐
783       est refresh. This will reactivate the previous snap revision, and  will
784       use  the original data that was associated with that revision, discard‐
785       ing any data changes that were done  by  the  latest  revision.  As  an
786       exception, data which the snap explicitly chooses to share across revi‐
787       sions is not touched by the revert process.
788
789       Usage: snap revert [revert-OPTIONS]
790
791       --no-wait
792              Do not wait for the operation  to  finish  but  just  print  the
793              change id.
794
795       --devmode
796              Put snap in development mode and disable security confinement
797
798       --jailmode
799              Put snap in enforced confinement mode
800
801       --classic
802              Put snap in classic mode and disable security confinement
803
804       --revision
805              Revert to the given revision
806
807   run
808       Run the given snap command
809
810       The run command executes the given snap command with the right confine‐
811       ment and environment.
812
813       Usage: snap run [run-OPTIONS]
814
815       --shell
816              Run a shell instead of the command (useful for debugging)
817
818       --strace [="with-strace"] <default: "no-strace">
819              Run the command  under  strace  (useful  for  debugging).  Extra
820              strace  options  can  be  specified  as well here. Pass --raw to
821              strace early snap helpers.
822
823       --gdb  Run the command with gdb
824
825       --trace-exec
826              Display exec calls timing data
827
828   save
829       Save a snapshot of the current data
830
831       The save command creates a snapshot of the  current  user,  system  and
832       configuration data for the given snaps.
833
834       By  default,  this  command  saves the data of all snaps for all users.
835       Alternatively, you can specify the data of which snaps to save, or  for
836       which users, or a combination of these.
837
838       If  a  snap  is  included in a save operation, excluding its system and
839       configuration data from the snapshot is not  currently  possible.  This
840       restriction may be lifted in the future.
841
842       Usage: snap save [save-OPTIONS]
843
844       --no-wait
845              Do  not  wait  for  the  operation  to finish but just print the
846              change id.
847
848       --abs-time
849              Display absolute times (in RFC 3339 format). Otherwise,  display
850              short relative times.
851
852       --users
853              Snapshot data of only specific users (comma-separated) (default:
854              all users)
855
856   saved
857       List currently stored snapshots
858
859       The saved command displays a list of snapshots that have  been  created
860       previously with the 'save' command.
861
862       Usage: snap saved [saved-OPTIONS]
863
864       --abs-time
865              Display  absolute times (in RFC 3339 format). Otherwise, display
866              short relative times.
867
868       --id   Show only a specific snapshot.
869
870   services
871       Query the status of services
872
873       The services command lists information about the services specified, or
874       about the services in all currently installed snaps.
875
876   set
877       Change configuration options
878
879       The   set   command  changes  the  provided  configuration  options  as
880       requested.
881
882           $ snap set snap-name username=frank password=$PASSWORD
883
884       All configuration changes are persisted at once,  and  only  after  the
885       snap's configuration hook returns successfully.
886
887       Nested values may be modified via a dotted path:
888
889           $ snap set snap-name author.name=frank
890
891       Configuration option may be unset with exclamation mark:
892           $ snap set snap-name author!
893
894       Usage: snap set [set-OPTIONS]
895
896       --no-wait
897              Do  not  wait  for  the  operation  to finish but just print the
898              change id.
899
900   start
901       Start services
902
903       The start command starts, and optionally enables, the given services.
904
905       Usage: snap start [start-OPTIONS]
906
907       --no-wait
908              Do not wait for the operation  to  finish  but  just  print  the
909              change id.
910
911       --enable
912              As  well  as  starting  the  service  now,  arrange for it to be
913              started on boot.
914
915   stop
916       Stop services
917
918       The stop command stops, and optionally disables, the given services.
919
920       Usage: snap stop [stop-OPTIONS]
921
922       --no-wait
923              Do not wait for the operation  to  finish  but  just  print  the
924              change id.
925
926       --disable
927              As well as stopping the service now, arrange for it to no longer
928              be started on boot.
929
930   switch
931       Switches snap to a different channel
932
933       The switch command switches the given snap to a different channel with‐
934       out doing a refresh.
935
936       Usage: snap switch [switch-OPTIONS]
937
938       --no-wait
939              Do  not  wait  for  the  operation  to finish but just print the
940              change id.
941
942       --channel
943              Use this channel instead of stable
944
945       --edge Install from the edge channel
946
947       --beta Install from the beta channel
948
949       --candidate
950              Install from the candidate channel
951
952       --stable
953              Install from the stable channel
954
955       --cohort
956              Switch the snap into the given cohort
957
958       --leave-cohort
959              Switch the snap out of its cohort
960
961   tasks
962       List a change's tasks
963
964       The tasks command displays a summary of tasks associated with an  indi‐
965       vidual change.
966
967       Usage: snap tasks [tasks-OPTIONS]
968
969
970       Aliases: change
971
972
973       --abs-time
974              Display  absolute times (in RFC 3339 format). Otherwise, display
975              relative times up to 60 days, then YYYY-MM-DD.
976
977       --last Select last change of given type (install, refresh, remove, try,
978              auto-refresh,  etc.).  A  question  mark  at the end of the type
979              means to do nothing (instead of returning an error) if no change
980              of  the  given  type is found. Note the question mark could need
981              protecting from the shell.
982
983   try
984       Test an unpacked snap in the system
985
986       The try command installs an unpacked snap into the system  for  testing
987       purposes.   The  unpacked  snap content continues to be used even after
988       installation, so non-metadata changes there go live instantly. Metadata
989       changes  such  as those performed in snap.yaml will require reinstalla‐
990       tion to go live.
991
992       If snap-dir argument is omitted, the try command will attempt to  infer
993       it  if either snapcraft.yaml file and prime directory or meta/snap.yaml
994       file can be found relative to current working directory.
995
996       Usage: snap try [try-OPTIONS]
997
998       --no-wait
999              Do not wait for the operation  to  finish  but  just  print  the
1000              change id.
1001
1002       --devmode
1003              Put snap in development mode and disable security confinement
1004
1005       --jailmode
1006              Put snap in enforced confinement mode
1007
1008       --classic
1009              Put snap in classic mode and disable security confinement
1010
1011   unalias
1012       Remove a manual alias, or the aliases for an entire snap
1013
1014       The  unalias command removes a single alias if the provided argument is
1015       a manual alias, or disables all aliases of  a  snap,  including  manual
1016       ones, if the argument is a snap name.
1017
1018       Usage: snap unalias [unalias-OPTIONS]
1019
1020       --no-wait
1021              Do  not  wait  for  the  operation  to finish but just print the
1022              change id.
1023
1024   unset
1025       Remove configuration options
1026
1027       The  unset  command  removes  the  provided  configuration  options  as
1028       requested.
1029
1030            $ snap unset snap-name name address
1031
1032       All  configuration  changes  are  persisted at once, and only after the
1033       snap's configuration hook returns successfully.
1034
1035       Nested values may be removed via a dotted path:
1036
1037            $ snap unset snap-name user.name
1038
1039       Usage: snap unset [unset-OPTIONS]
1040
1041       --no-wait
1042              Do not wait for the operation  to  finish  but  just  print  the
1043              change id.
1044
1045   version
1046       Show version details
1047
1048       The  version  command  displays  the  versions  of  the running client,
1049       server, and operating system.
1050
1051   wait
1052       Wait for configuration
1053
1054       The wait command waits until a configuration becomes true.
1055
1056   warnings
1057       List warnings
1058
1059       The warnings command lists the warnings that have been reported to  the
1060       system.
1061
1062       Once warnings have been listed with 'snap warnings', 'snap okay' may be
1063       used to silence them. A warning that's been silenced in this  way  will
1064       not  be listed again unless it happens again, _and_ a cooldown time has
1065       passed.
1066
1067       Warnings expire automatically, and once expired they are forgotten.
1068
1069       Usage: snap warnings [warnings-OPTIONS]
1070
1071       --abs-time
1072              Display absolute times (in RFC 3339 format). Otherwise,  display
1073              relative times up to 60 days, then YYYY-MM-DD.
1074
1075       --unicode <default: "auto">
1076              Use a little bit of Unicode to improve legibility.
1077
1078       --all  Show all warnings
1079
1080       --verbose
1081              Show more information
1082
1083   watch
1084       Watch a change in progress
1085
1086       The  watch  command  waits  for the given change-id to finish and shows
1087       progress (if available).
1088
1089       Usage: snap watch [watch-OPTIONS]
1090
1091       --last Select last change of given type (install, refresh, remove, try,
1092              auto-refresh,  etc.).  A  question  mark  at the end of the type
1093              means to do nothing (instead of returning an error) if no change
1094              of  the  given  type is found. Note the question mark could need
1095              protecting from the shell.
1096
1097   whoami
1098       Show the email the user is logged in with
1099
1100       The whoami command shows the email the user is logged in with.
1101
1102
1103
1104                               25 November 2019                        snap(8)
Impressum