Getting Started

Intro to Ubuntu IoT Developer documentation

Ubuntu IoT Developer documentation covers the core set of platform and service technologies that make up Ubuntu’s Internet of Things (IoT) offering. It includes a set of Ubuntu operating systems geared towards different device use cases and associated cloud services.

Classic Ubuntu includes the traditional Ubuntu Desktop, Ubuntu Server and Ubuntu Cloud distributions. These are well-known distributions and have broad support for various device configurations including user-interactive desktop systems, enterprise server systems and Internet of Things (IoT) devices. Ubuntu Desktop, Server and Cloud are widely deployed across diverse public and private sectors by millions of people and thousands of organizations. Built from the common Ubuntu Debian package archives, they are well-known, time-tested and proven in the field.

Ubuntu Core is the newest Ubuntu operating system (OS). It primarily targets the requirements of headless IoT devices and their distributors. It is a minimalist rendition of Ubuntu that is lightweight, highly secure, and transactionally updated. Every application and data are isolated from every other application and data. An Ubuntu Core system is built using snaps: a core snap, a kernel snap, a gadget snap, and usually runs one or more application snaps. Canonical provides reference snaps and OS images for some current best-of-breed IoT platforms; you can also roll your own image. Ubuntu Core uses a rolling release model that aligns with Ubuntu LTS releases. The latest Ubuntu Core is currently UC16 and is based on the 16.04 long-term support release of classic Ubuntu. UC18 is currently under development and its beta is set to release at the same time as the 18.04 long-term support release of Ubuntu.

Ubuntu Core high level features

  • Faster, more reliable, with stronger security guarantees for applications and users compared to a traditional Linux distribution.
  • Atomic transactional upgrades for applications and the OS itself, all of which can be rolled back if needed automating most maintenance and upgrades.
  • Separation of OS and application files into sets of distinct read-only images, to easily and securely add multiple applications and additional functionality onto a device.
  • Applications are distributed via snaps, a simple application packaging system that makes it easy for developers to build and distribute applications across many Linux distributions from a public or private app store.
  • Public/private key-based validation and authentication is built-in at every stage, proving that what runs is exactly what OS and app developers intend.

Key Differences between Core and classic Ubuntu

Core classic
Minimum requirements 500 MHz single core processor256 MB RAM512 MB storage 1 GHz dual core processor512 MB RAM1.5 GB storage
Graphical UI None by default (can utilize Wayland or Mir) Xorg and GNOME Shell or Wayland and GNOME Shell
Package system snaps Debs & snaps
Application security Isolation via AppArmor and Seccomp Traditional user and group permissions (for Debs);Strict isolation via AppArmor and Seccomp for snaps;Transitional security with classic confinement for snaps
Updates Pushed from the Global (public) store & optionally a Brand (private) store;All updates are transactional Traditional apt repository updates;Also from public store & optionally Brand store for snaps;Updates for snaps are transactional


Snap is the native Ubuntu Core packaging system. There is no Debian package support in the runtime of Ubuntu Core. And, Snaps are increasingly used in classic Ubuntu flavours and other Linux distributions.

Snaps solve multiple problems at the same time:

  • It’s easy to package applications pulled from multiple upstream sources using diverse build systems. Each snap includes its own dependencies, freeing publishers from problems when implicit dependencies change without their knowledge.
  • Developers publish snaps in a snap store (the global snap store or a private Brand store) and take responsibility for their quality, making software distribution fast and free of procedural obstacles.
  • Snaps are sandboxed from each other and from the OS, providing system stability and overall security. Powerful slot-and-plug (“interface”) capabilities enable content sharing of all kinds, including data, sockets, D-Bus and much more.
  • Snaps use simple declarations for system access (for example network or GPIO), and IoT product developers control whether and how this access is granted.
  • Automatic roll-backs to a previous installed revision occur if a snap upgrade issue arises, with manual reversion as needed.

Snaps are created for device systems that need to have high availability, security and be very robust. They are specifically geared towards delivering applications and their updates in a transactional, minimal downtime manner to devices that don’t have a lot or any direct human interaction. Snaps also work well on all Ubuntu Classic flavours (Desktop and Server editions) alongside traditional Debian packages and bring a greater level of predictability, security and robustness to all of Ubuntu.

Snaps are much more rapid to work with than traditional Linux packaging like Debian or RPM packages. You can snap up a simple application and be testing it on a real system in minutes. Snaps pair with the global snap store or a private brand store that make it easy to deliver your applications to devices.

For more detailed information about snaps including what they are, an architectural overview and how to get started with them, please see the full snap documentation.


Stores are a key part of Ubuntu IoT development as they provide a mechanism to store and deliver versions of applications packaged as snaps to devices. Without a store, a vendor has to manually distribute their snaps to their users having a difficult time keeping track of who’s received the latest version of their application.

The most general type of store is the global snap store. It is the default store that every modern Linux distribution with snapd installed points to and from which to retrieve snaps. It is public and it is global so that a common repository of software is available and searchable to as wide an audience as possible. Anyone with a valid Ubuntu SSO account may publish and distribute their snapped application via the global snap store.

The global snap store has a concept of paid apps which places some restrictions on who can download an application. All paid applications are searchable in the store just like non-paid apps. However, paid applications can only be installed after a user has paid for gaining access to this application.

You may follow this step-by-step guide that will show you how to distribute snaps to your devices through the snap store.

Another type of store that can be used for distributing snaps to devices is one called a Brand store. A Brand store provides you with the ability to restrict the scope with which your snaps are visible, which gives you complete control over what devices may search and install your applications.

A Brand store can be configured such that it can inherit all snaps from the global snap store and/or inherit snaps from another Brand store. It is possible to inherit snaps from as many other stores as desired creating as flexible of a hierarchy as needed to deliver your snaps and control the deployment to the right set of devices.

The following table covers some scenarios when you’d want to use the global snap store versus a private Brand store.

Scenario Global Snap Store Private Brand Store
Distribute an application to anyone
Distribute an application to certain clients via a paywall
Distribute an application to a specific set of client devices
Canonical-hosted store solution
Can be proxied and cached on local premises
*Self-hosted store solution

(* A self-hosted store solution is an upcoming feature).

There are many other important things to know about the global snap store and Brand stores. These are covered in greater detail in later sections of this documentation.

Follow this guide to request a Brand store or get in contact with someone from Canonical to learn more about getting your own Brand store.


There are several hardware platforms that run Ubuntu Core with snaps. Each has a pre-built reference image that you are able to get started with right now. This section describes each and points you to more information on getting started with these. These reference platforms/Ubuntu Core images are meant to get you started evaluating and working with Ubuntu Core as quickly and inexpensively as possible. If a particular reference platform matches your own use cases, you may take these Canonical-provided images and customize them for your purposes.

The following table shows the reference hardware platforms that run Ubuntu Core and use snaps:

Platform Name Hardware Description
Raspberry Pi 2 ARM H2 Quad-core Cortex-A7 64-bit CPU
256/512 MB of RAM
No built-in flash storage
Raspberry Pi 3 Broadcom BCM2837 4x ARM Cortex-A53 64-bit CPU
1 GB of RAM
No built-in flash storage
Raspberry Pi Compute Module 3 Broadcom BCM2837 4x ARM Cortex-A53 64-bit CPU
1 GB of RAM
No built-in flash storage
Orange Pi Zero ARM H2 Quad-core Cortex-A7 64-bit CPU
256/512 MB of RAM
No built-in flash storage
Qualcomm Snapdragon 410c ARM Quad-core Cortex A53 64-bit CPU
1 GB of RAM
8 GB eMMC on-board flash storage
Intel NUC Intel Core i3, i5, i7 64-bit CPU
Up to 32 GB of RAM
No built-in flash storage
Samsung Artik 5 ARM Dual/Quad Core Cortex-A7 64-bit CPU
512 MB/1 GB of RAM
4 GB eMMC on-board flash storage
Samsung Artik 10 ARM Quad Cortex-A15 + quad Cortex-A7 64-bit CPU
2 GB of RAM
16 GB eMMC on-board flash storage
KVM Full x86 32/64 bit CPI software virtualization platform

There are official images produced by Canonical for these specific hardware platforms. Also, Ubuntu community members work with and produce images for other platforms and CPUs. Refer to these individual projects for more information on what other unofficial images might work for your use cases.

For more information on getting started developing your own Ubuntu Core image and configuring a useful developer setup, refer to this documentation.


Assertions are digitally signed documents that express a fact or policy by a particular signing authority about a particular object in the snap ecosystem. While assertions may seem like a technical detail that most people don’t need to understand, they are a fundamental and widely used concept to snaps and Ubuntu.

Assertions are the way trusted information is transmitted between the different parts of the snap ecosystem (snapd daemon, snapcraft tool and store). They are used for things like stating who is the publisher of a snap, who is the creator of a device image, and for allowing specific actions if the right assertion is provided (e.g. creating a system user). They’re meant as a way to know that different parts of a snap system can be trusted and are robust when system parts change.

An assertion consists of a set of structured headers, which vary based on the particular type of assertion, an optional body (UTF-8 text, with format depending on type of assertion) and a signature.

Assertions are intended to be understandable by human inspection, although full validation requires the use of provided tooling.

The following table summarizes the various types of assertions that exist and what they’re used for:

Assertion Type Use Case
account Ties a name for an account to its identifier and provides the authority's confidence in the name's validity.
account-key Holds a public key belonging to an SSO account.
model Lists the properties of a device model. It should contain all needed information to create a working Ubuntu Core image.
serial Binds a particular device identity to a device public key.
snap-declaration Defines some of the properties of a snap such as the snap-id, the official snap name, the publisher, etc.
snap-build Defines the basic properties of a snap at the time it was built by the developer.
snap-revision Acknowledges receipt of a build of a snap and labels it with a snap revision.
system-user A permit by the brand for local system users to be created on specific devices.
validation Shows that a certain revision for a snap that is gated by another snap has been validated for a given Ubuntu Core series.

More details about assertions will be covered in greater detail in later sections of this documentation.


Ubuntu Core is part of the larger IoT ecosystem which includes various things like snapd, other operating systems, the snap store, enterprise proxy, etc. The documentation for these other things are contained elsewhere. This section provides some convenient links to these other technologies and their respective documentation.

Snap and snapd documentation

Snap and snapd are the technologies behind the snap packaging format. They provide the command line and behind-the-scenes services that allow snap packages to be installed on a system and kept up-to-date. The documentation for snap and snapd is located on the site. There is also a public forum where you are able to interact with other people involved in the snap community by asking and answering questions.

You can find the source code to snap and snapd on github.


There is also the Ubuntu Tutorials site that covers tutorials about creating and working with snaps, creating new Ubuntu images (both classic Ubuntu and Core), advanced snap usage such as snapping up applications using various programming languages, integrating a continuous integration (CI) system into working with snaps, and much more.

Introduction to snap architecture

Snaps are different from other packaging systems and require a different way of thinking when working with them. One main concept is to provide a highly robust system in which applications and daemons are isolated from each other and any co-interaction is carefully mediated. Tighter security and a system always being in a known good state are the two most significant characteristics of a system based on snaps, such as Ubuntu Core.

On an Ubuntu Core system, only snaps are used for installing new software. Debian packages are not supported and will not work on Ubuntu Core. This makes Ubuntu Core more robust than using a system like classic Ubuntu where both Debian and snap packages coexist. The tradeoff of this is a decrease in flexibility when working with Ubuntu Core since snap package confinement requires more attention to detail. Sharing resources or required external communication between your application and other parts of the system, requires an interface declaration.

Interfaces are defined as an internal declaration within snapd. Many existing common interfaces exist with most being reusable by any snap.

As an example of what an interface is used for, in order for a snap to gain access to the data in a user’s home directory, a snap needs to use the home interface.

More information on the specifics of how snaps work and how they’re architected is available in the snap documentation.