OSTREE-STATIC-DELTA(1)

📦
version 2026.6 · 16 versions
, in arch rolling

💅 ostree-static-delta · OSTREE STATIC-DELTA(1) 💅

okay bestie, welcome to the OSTREE STATIC-DELTA(1) page — this is the ostree-static-delta glow-up, and we're managing static delta files together. no cap, it's niche but iconic. ✨

🌸 NAME 🌸

ostree-static-delta — manage static delta files. that's the name section, short and slay. 🎀

🦋 SYNOPSIS 🦋

peep the exact shapes these commands take:

ostree static-delta list

ostree static-delta show

ostree static-delta delete

ostree static-delta generate {--to=REV} [OPTIONS...]

ostree static-delta apply-offline [OPTIONS...] {PATH} [KEY-ID...]

ostree static-delta verify [OPTIONS...] {STATIC-DELTA} [KEY-ID...]

💅 DESCRIPTION 💅

okay so this whole command family is here to list and manipulate static delta files. lowkey powerful. 🦋

A delta generated with a signature (see --sign-type and --sign under 'Generate' Options) is written in a different on-disk format, in which the superblock is wrapped in a signed envelope. The show and verify subcommands read that envelope, but ostree static-delta apply-offline is the only command that can apply a delta wrapped in one. ostree pull parses a fetched superblock directly, so a pull that reaches for a signed delta fails with Invalid checksum of length 0 expected 32. A pull into an archive-mode repository does not reach that point, because such a pull does not use static deltas at all. Signed static deltas are therefore for offline application only, such as from removable media. A delta that will be served to ostree pull clients must be generated unsigned. 💀

✨ GENERATE OPTIONS ✨

  • --from="REV" — create delta from revision REV.
  • --to="REV" — create delta to revision REV. this one is required, periodt. The delta is from the parent of REV, unless specified otherwise by --from or --empty.
  • --empty — create delta from scratch.
  • --max-usize=SIZE — maximum uncompressed size in megabytes.
  • --sign-type=ENGINE — use particular signature engine. Currently available ed25519 and dummy signature types. The default is ed25519. signing a delta makes it applicable only by ostree static-delta apply-offline; see the Description above.
  • --sign="KEY-ID" — there KEY-ID is:
    • for ed25519: base64-encoded secret key for signing.
    • for dummy: ASCII-string used as secret key.

🎀 APPLY-OFFLINE OPTIONS 🎀

  • KEY-ID — there KEY-ID is:
    • for ed25519: base64-encoded public key for verifying.
    • for dummy: ASCII-string used as public key.
  • --sign-type=ENGINE — use particular signature engine. Currently available ed25519 and dummy signature types.
  • --keys-file — read key(s) from file filename. Valid for ed25519 signature type. For ed25519 this file must contain base64-encoded public key(s) per line for verifying.
  • --keys-dir — redefine the system path, where to search files and subdirectories with well-known and revoked keys.

🔥 VERIFY OPTIONS 🔥

  • KEY-ID — there KEY-ID is:
    • for ed25519: base64-encoded public key for verifying.
    • for dummy: ASCII-string used as public key.
  • --sign-type=ENGINE — use particular signature engine. Currently available ed25519 and dummy signature types. The default is ed25519.
  • --keys-file — read key(s) from file filename. Valid for ed25519 signature type. For ed25519 this file must contain base64-encoded public key(s) per line for verifying.
  • --keys-dir — redefine the system path, where to search files and subdirectories with well-known and revoked keys.

🌈 EXAMPLE 🌈

this is what it looks like when you just run it with no subcommand, bestie:

$ ostree static-delta

                   (No static deltas)

and that's the tea, bestie 🫶 — source/version: OSTree; manual: OSTREE STATIC-DELTA(1); date: this page doesn't list one, so no invented timestamp here, periodt. 💖

📦 where this page comes from