MAQPNADocs

maqpna config bundle build

Build and sign a configuration bundle from a directory

Operate-o json | yaml

Synopsis#

maqpna config bundle build DIR --key URI --out FILE [--revision N] [--issuer S] [--expires DUR] [--not-before T]

Flags#

FlagTypeDescriptionDefault
--expiresdurationvalidity after creation, e.g. 168h (default: no expiry)none
--issuerstringissuer recorded in the manifest (default: $USER@maqpna-cli)none
--keystringsigning key: a PKCS#8 PEM file, file:///…, kms://aws|gcp|azure|vault|openbao/…, azurekv://…, or pkcs11:… in -tags pkcs11 buildsnone
--not-beforestringnot valid before this time (RFC3339)none
--outstringbundle file to write (.tar.gz)none
--pq-keystringML-DSA key (maqpna keys generate --alg ML-DSA-65): also sign with it (hybrid)none
--revisionintrevision (default: the current Unix time); gateways apply only a revision above theirsnone

The global flags (--context, -o, --no-color, ...) work with every command.

Examples#

maqpna config bundle build ./rendered --key file:///etc/maqpna/bundle.key --out edge.tar.gz --expires 168h

What happens when you run it#

  • Prints a table by default; -o json or -o yaml print the data, and --jq EXPR filters the JSON.

Exit codes#

CodeMeaning
0success
1error (the message says what failed, with a hint when there is one)
2usage error: unknown flag, missing argument or bad value; the synopsis is printed
3a check failed, a change is blocked, or a result did not match (tamper, policy mismatch) (not used by this command)