Base Layer

Runs must be configured with a base layer, which is an operating system configured to support Mint's functionality.

If you received a warning message about needing to specify the base configuration, see the Initial Base Definition Instructions.

Configuration

Configure the base layer by specifying the base key with os and tag. The os specifies the operating system, and the tag specifies the Mint configuration of that operating system.

base:
  os: ubuntu 24.04
  tag: 1.0

tasks:
  - key: check-os
    run: cat /etc/os-release

Supported Base Layers

The following base layers are currently supported:

ostag
ubuntu 24.041.0
ubuntu 22.041.0

Ubuntu 24.04

The Mint 1.0 tag of Ubuntu 24.04 is configured with Docker 28.0.4

Ubuntu 22.04

The Mint 1.0 tag of Ubuntu 22.04 is configured with Docker 26.0.1

CLI

mint resolve base will automatically insert the default base configuration into all run definitions (requires version 1.4 or greater of the Mint CLI)

Embedded Runs

Embedded runs can use a different base than the runs which embed them.

If a run only contains embedded runs, then the base configuration does not have any effect since the embedded runs must specify their own base.

Tool Caches

Tool caches are unique to each base layer. Specifying the same tool-cache configuration with a different base layer will result in a different cache.