canonical livepatch #0

Supports: bionic xenial trusty focal
Add to new model


This charms installs and configures the Ubuntu Linux Livepatching Utility and Daemon


This subordinate charm provides live kernel updates to its unit via the Canonical Livepatch Service.

The canonical-livepatch software is automatically installed from the Snap Store.

You will need to supply your key from via juju set (1.x) or juju config (2.x)

Nagios checks are automatically deployed if you add an appropriate nrpe-external-master relation.


This is a subordinate charm, so must be related to your primary service(s):

juju deploy canonical-livepatch

juju add-relation <your_primary_charm_name> canonical-livepatch

You will need to supply your key from via juju set (Juju 1.x):

juju set canonical-livepatch livepatch_key=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Or via juju config (Juju 2.x)

juju config canonical-livepatch livepatch_key=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx


The livepatch_key setting must be configured in order for the software to function correctly - see above.

By default, the livepatch software will attempt to retrieve its patch data directly over the network. If you'd like to use a proxy for this traffic instead, you can set the livepatch_proxy value to the address of your proxy server.

Likewise, if you need to use a proxy server to access the Snap Store, snap_proxy can also be set to the address of your proxy server.

Alternatively, if you've configured a proxy for all applications in your environment via juju model-config, the charm will detect this and automatically do the right thing. It'll use http-proxy or https-proxy if either are set, with the latter being preferred.

If two different proxies are set via model config and charm config, the latter will be preferred.


To run tests use: make test

Note: functional tests are not available on trusty.

Contact Information

This charm is maintained here, by the llama-charmers team:

Canonical Livepatch Service


(string) Use ua client token to enable Ubuntu Advantage services, if not enabled. Livepatch will be enabled using ua cli instead
(boolean) Enable installation on container for testing purpose.
(string) Space separated list of extra deb packages to install.
(string) List of signing keys for install_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.
(string) List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.
(string) In order to get started please login and generate a key from: You can then use that value here to activate canonical-livepatch
(string) The address of a proxy server to use for livepatch traffic e.g.
(string) Used by the nrpe subordinate charms. A string that will be prepended to instance name to set the host name in nagios. So for instance the hostname would be something like: juju-myservice-0 If you're running multiple environments with the same services in them this allows you to differentiate between them.
(string) A comma-separated list of nagios servicegroups. If left empty, the nagios_context will be used as the servicegroup
(string) The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".
(string) Snap Store channel from which to install the Canonical Livepatch snap. Most people will not need to change this.
(string) DEPRECATED. Use snap-http-proxy and snap-https-proxy model configuration settings. HTTP/HTTPS web proxy for Snappy to use when accessing the snap store.
(string) DEPRECATED. Use snap-store-proxy model configuration setting. The address of a Snap Store Proxy to use for snaps e.g.
(string) How often snapd handles updates for installed snaps. The default (an empty string) is 4x per day. Set to "max" to check once per month based on the charm deployment date. You may also set a custom string as described in the 'refresh.timer' section here: