Skip to content

Engine definitions and custom commands

10 min · Screen: /admin/engine-definitions · Needs: Permissions.EngineDefinitions.Manage

Engine definition

A YAML file that teaches the platform an engine: how to detect it, read its version, back it up, restore it, validate and clean up.

Custom command

One backup profile whose capture is a command you write - for a one-off system.

Recipes

Ready-made custom commands to import and adapt.

  1. Open Admin › Engine definitions and click Upload definition

  2. Read the lint report

    Every version is checked before it can be approved.

  3. Ask a colleague to approve it

    A definition runs commands on production hosts, so it is treated as privileged code: it runs only after somebody other than its author has approved exactly that YAML.

  4. Register instances of the new engine

    It appears as an engine in Register a database.