Configuration reference

Generated from the schema in crates/zp-config/src/schema.rs. Don’t edit this file: ZP_BLESS=1 cargo test -p zp-config regenerates it, and the tests fail if it’s stale. The guide with examples is docs/user/configuration.md.

/etc/zenpac/zenpac.toml

Key	Type	Default	Description
appstream	boolean	true	Install the official repos’ AppStream catalogs with update, which software centers list applications from, into /var/lib/swcatalog. false removes the ones installed, e.g. on a server without a software center.
arch	string	"auto"	The system architecture: auto (detected) or an arch name.
cache_dir	string	"/var/cache/zenpac"	Downloaded packages and other re-creatable data.
elevate	auto | run0 | sudo | doas | never	"auto"	How a user gets root for a change, after confirming its plan: auto (the first of run0, sudo and doas installed), one of them, or never.
state_dir	string	"/var/lib/zenpac"	The local store and the repo indexes.
ui.color	auto | always | never	"auto"	Colored output.
ui.progress	auto | always | never	"auto"	Progress bars.
ui.unicode	auto | always | never	"auto"	Unicode symbols (otherwise ASCII).

sources.d/*.toml: [source.<name>]

Key	Type	Default	Description
base	string	—	The base URL, e.g. https://repos.zenlinux.org. Required.
db	string	—	The DB URL template. Placeholders: {base}, {namespace}, {repo}, {arch}. Default: the Zen layout, {base}/{namespace}/{repo}/{arch}/{namespace}-{repo}.db.
mirror_of	string	—	zenlinux for a mirror or test instance of the official source: it may then serve the reserved namespaces.
namespace	string	—	The namespace URL template, where index.json and key.asc live. Placeholders: {base}, {namespace}. Default: {base}/{namespace}.

repos.d/*.toml: [repo."<namespace>/<repo>"]

Key	Type	Default	Description
enabled	boolean	—	Whether it’s used. Default: true (zen/test: false).
fingerprint	string	—	The pinned key fingerprint of a user repo.
priority	integer	—	Order within its tier, higher first. Official repos always rank above user repos. Default: 0 (zen/core 10, zen/test 20).
signatures	none | required	—	Signature policy. Default: none for official repos, required for user repos.
source	string	—	The source it comes from. Default: zenlinux.