How to choose OS images

Errors or typos? Topics missing? Hard to read? Let us know.

Switch image streams

• Candidate stream (UI): Go to Images > Change source > Custom, set URL to http://images.maas.io/ephemeral-v3/candidate, and Connect.
• Stable stream (UI): Set URL to http://images.maas.io/ephemeral-v3/stable and Connect.
• CLI:

BOOT_SOURCE_ID=$(maas $PROFILE boot-sources read | jq '.[] | select(.url | contains("images.maas.io/ephemeral-v3")) | .id')
maas $PROFILE boot-source update $BOOT_SOURCE_ID url=$STREAM_URL

Import standard images

• Default: MAAS auto-downloads Ubuntu LTS (amd64). To remove an image, uncheck and save.
• Host mirrors: Images > Change source > Custom, enter mirror URL, and Connect.

Import non-Ubuntu images

• Import non-Ubuntu images via Images > Other Images.

Sync images

• Sync hourly at region level, every 5 min at rack level.

List boot sources (CLI)

maas $PROFILE boot-sources read

Select boot sources (CLI)

maas $PROFILE boot-source-selections create $SOURCE_ID os="ubuntu" release="$SERIES" arches="$ARCH" subarches="$KERNEL" labels="*"

Get HWE kernels (CLI)

maas $PROFILE boot-source-selections create $SOURCE_ID os="ubuntu" release="xenial" arches="amd64" subarches="hwe-16.04" labels="*"

Import or list available images

• Import:

maas $PROFILE boot-resources import

• List available:

maas $PROFILE boot-resources read

Delete or edit boot sources

• Delete:

maas $PROFILE boot-source delete $SOURCE_ID

• Edit:

maas $PROFILE boot-source update $SOURCE_ID url=$URL keyring_filename=$KEYRING_FILE

Add a boot source

maas $PROFILE boot-sources create url=$URL keyring_filename=$KEYRING_FILE

Use a local image mirror

• Use the default keyring:

KEYRING_FILE=/usr/share/keyrings/ubuntu-cloudimage-keyring.gpg

Re-create default boot source

• Use these values:

URL=https://images.maas.io/ephemeral-v3/stable
KEYRING_FILE=/usr/share/keyrings/ubuntu-cloudimage-keyring.gpg

Create a local MAAS image mirror

1. Install SimpleStreams:

   sudo apt install simplestreams
   

2. Set variables:

   KEYRING_FILE=/usr/share/keyrings/ubuntu-cloudimage-keyring.gpg
   IMAGE_SRC=https://images.maas.io/ephemeral-v3/stable
   IMAGE_DIR=/var/www/html/maas/images/ephemeral-v3/stable
   

3. Mirror kernels:

   sudo sstream-mirror --keyring=$KEYRING_FILE $IMAGE_SRC $IMAGE_DIR 'arch=amd64' 'release~(bionic|focal)' --max=1 --progress
   sudo sstream-mirror --keyring=$KEYRING_FILE $IMAGE_SRC $IMAGE_DIR 'os~(grub*|pxelinux)' --max=1 --progress
   

Notes

• Use --dry-run to preview before downloading.
• Verify image availability at: http://<myserver>/maas/images/ephemeral-v3/stable/
• Schedule regular updates using cron.

---

Last updated 29 days ago.