carta
cloud-init-per(1)

cloud-init-per1

Run a command with arguments at a specific frequency

Usage

cloud-init-per <frequency> <name> <cmd> [arg1 [arg2 []]]

Overview

Run a command with arguments at a specific frequency.

This utility can make it easier to use boothooks or bootcmd on a per "once" or "always" basis. For example:

- [ cloud-init-per, once, mymkfs, mkfs, /dev/vdb ]

The cloud-init-per command replaced the cloud-init-run-module command.

Options

frequency

This can be one of the following values:

once: run only once and do not re-run for new instance-id

instance: run only once for a given instance-id and re-run for new instance-id

always: run every boot

name

A name to give the command to run to show up in logs.

cmd [ arg1 [ arg2 [...]]]

The actual command to run followed by any additional arguments.

History

  • Arch Linux 2026-11-01 to Debian 13 (Trixie): the text shown here
  • Debian 12 (Bookworm) to Debian 11 (Bullseye)

From cloud-init 26.2-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.