Skip to content

Resource Reference

Sinter v1.3.0 implements nine resource types. Parameters below are the complete supported set — unknown with fields are schema errors.

Type Purpose Key parameters
file Regular file content + metadata path, state, content/source, owner, group, mode
directory Directory presence + metadata path, state, owner, group, mode
link Symbolic links path, target, state
template Rendered controller-side templates path, source, vars, mode
command Exact-argv program execution program, args, creates/removes, changed_when, register
package Package install/remove (apt/dnf) name, state
service systemd state + enablement name, state, enabled
group Local Linux group name, state, gid, system
user Local Linux user name, state, uid, group, groups, shell, home, create_home, system, password_hash
  • path-type parameters are absolute paths; parent paths must already exist and pass the trust-boundary check (no unexpected symlinks).
  • mode is always a quoted four-digit octal string ("0644").
  • state defaults to present for filesystem resources; package requires it explicitly.
  • Content publication is atomic (rename); existing metadata is preserved when omitted.
  • All types are idempotent — a converged resource mutates nothing on re-apply.