Aether Bricks

Bricks are versioned, declarative packages that tell a Kiln Relay how to run a server. This repository is Aether's public Brick catalog: an official recipe index plus kiln.brick/v1 recipes for the servers we run.

catalog.yml recipe index (kiln.catalog/v1)
recipes/ kiln.brick/v1 recipes
schema/ machine-readable format schemas
docs/ format and authoring documentation
tests/ catalog validation suite

A recipe is intentionally data, not Relay code. It selects any OCI image, declares user-configurable variables, maps them into environment and resource settings, and describes ports and routing. A Relay that understands the recipe's format can run a new Brick without being updated.

Validate locally

npm install
npm test

Every recipe in recipes/ must be listed in catalog.yml, satisfy the v1 schemas in schema/, and pass the shared rules in tests/catalog.test.mjs.

Deploying

Once this catalog is on main, individual recipes deploy by their raw HTTPS URL, for example:

https://raw.githubusercontent.com/AetherMinecraft/Bricks/main/recipes/purpur.yml

Recipes use the official prebuilt Ember images published by Kiln:

ghcr.io/kiln-site/bricks-java:11
ghcr.io/kiln-site/bricks-java:17
ghcr.io/kiln-site/bricks-java:21
ghcr.io/kiln-site/bricks-java:25
ghcr.io/kiln-site/bricks-steamcmd:latest

Recipes may use these images or any other OCI image with a public source.

See the v1 specification and contribution guide.