Ubuntu Core configuration
Ubuntu Core supports a set of system-wide options that allow you to customise your snap and core environment.
As with Configuration in snaps, these options are changed with the set
and get
commands, but with a target of system instead of a specific snap:
$ snap set system some.option="some value"
$ snap get system some.option
Configuration options can be unset by either passing their names to the unset command or by adding an exclamation mark (!) to the end of an option name: (from snapd 2.41+):
$ snap unset system some.option
$ # or
$ snap set system some.option!
Typing snap get system
outputs a top-level view of system-wide option categories which can be added as arguments to view their contents:
$ snap get system
Key Value
experimental {...}
refresh {...}
seed {...}
$ snap get system experimental
Key Value
experimental.hotplug true
experimental.layouts true
Default device configuration:
See Gadget snaps for details on how to create a default set of configuration values for a device.
pi-config
On a Raspberry Pi, the following options set corresponding values in the config.txt system configuration file:
- pi-config.disable-overscan
- pi-config.framebuffer-width
- pi-config.framebuffer-height
- pi-config.framebuffer-depth
- pi-config.framebuffer-ignore_alpha
- pi-config.overscan-left
- pi-config.overscan-right
- pi-config.overscan-top
- pi-config.overscan-bottom
- pi-config.overscan-scale
- pi-config.display-rotate
- pi-config.hdmi-group
- pi-config.hdmi-mode
- pi-config.hdmi-drive
- pi-config.avoid-warnings
- pi-config.gpu-mem-256
- pi-config.gpu-mem-512
- pi-config.gpu-mem
Further details on the above, see the official Raspberry Pi documentation.
proxy.{http,https,ftp}
These options may be set to change the proxies to be used by the system when communicating with external sites that speak the respective protocols.
Available since snapd 2.28.
refresh
There are four system-wide options that are used to manage how updates are handed:
- refresh.timer: defines the refresh frequency and schedule
- refresh.hold: delays the next refresh until the defined time and date
- refresh.metered: pauses refresh updates when network connection is metered
- refresh.retain: sets how many revisions of a snap are stored on the system
See Controlling updates for further details on how the above options are used.
resilience.vitality-hint
This option adjusts the Linux kernel’s out-of-memory (OOM) killer behaviour for specific snap services.
By default, all snap services have the same value for systemd’s OOMScoreAdjust
. By passing a list of snaps ordered by decreasing importance to the resilience.vitality-hint
system option, the order is respected if snap processes are killed in low memory situations.
The list of snaps need to be as string containing comma separated snap instance names in decreasing order of importance, such as:
snapA,snapB,snapC
In the above example, services inside snapA
are the least likely to be killed in out of memory situations, followed by services in snapB
, services in snapC
, and then the services in all the other snaps not referenced by the vitality-hint
option.
Snaps added to
resilience.vitality-hint
are still more likely to be killed than the snap daemon, snapd, itself.
Available since snapd 2.46.
service.console-conf.disable
May be set to true to disable the console-conf system configuration wizard that is launched by default when booting an initialised Ubuntu Core image.
Available since snapd 2.46.
service.ssh.disable
May be set to true to disable the SSH service at startup.
Available since snapd 2.22.
snapshots.automatic.retention
Automatic snapshot retention time is configured with the snapshots.automatic.retention
system option. The default value is 31 days, and the value needs to be greater than 24 hours:
$ snap set system snapshots.automatic.retention=30h
To disable automatic snapshots, set the retention time to no
:
$ snap set system snapshots.automatic.retention=no
Disabling automatic snapshots will not affect preexisting, automatically generated snapshots, but only those generated by subsequent snap removals.
Automatic snapshots require snap version 2.39+.
store-certs
A custom SSL certificate can be added to snapd’d trusted certificates pool for the store communication with the store-certs.<name>=<value>
system option.
To add a certificate, enter the following:
$ snap set system store-certs.cert1="$(cat /path/to/mycert)"
A certificate can be removed with unset:
$ snap unset system store-certs.cert1
Available since snapd 2.45
system.disable-backlight-service
May be set to true to disable the backlight service.
Available since snapd 2.46.
system.power-key-action
Defines the behaviour of the system when the power key is pressed.
May be set to one of:
- ignore
- poweroff
- reboot
- halt
- kexec
- suspend
- hibernate
- hybrid-sleep
- lock
Available since snapd 2.23.
system.timezone
May be used to set a time zone value, as typically found in /usr/share/zoneinfo
, such as America/Chicago
.
Available since snapd 2.46.
Last updated 3 days ago. Help improve this document in the forum.