Skip to content
SHC Docs

shc.yaml (design)

Status: built (SHC-1361). The author reference is shc.yaml. The loader (ce modules/app/shcyaml.go, LoadShcYAML) reads a rendered shc.yaml, refuses every key this table does not name, and writes the compose document the compose path renders; an install reads shc.yaml whenever an app has one, and shc convert writes one from a compose template. Clay, 2026-10-02: an app may be its own file, “just an shc.yaml file”, and “it wouldn’t respect the compose file if you did that.” The schema “doesn’t do all the backwards compatibility stuff”; “you can only do expose for ports, it has to be explicit the way our schema is, and it doesn’t do the x-shc stuff.” This note is that schema. It is written against ce e8398c2e232c, the commit shc next pinned on 2026-10-04 (it has moved on since), and it edits neither the replica project contract nor groups.

A compose file stays the bring-your-own and import path, with its enrichment and its x-shc-* keys. This file is the other way to write an app, and the recommended one. The loader’s refusals are X400530SHYUNK (not a key), X400531SHYCMP (a compose key), X400532SHYXSH (an x-shc key), X400533SHYPRT (a host side on a port), X400534SHYHST (a host path), X400535SHYVAL (a value), X400536SHYPRV (the privileged class outside privileges:) and X400537SHYDOC (not one mapping). Each names the service and the key.

An app directory is what it is now (app.yaml, vars.yaml, backup.yaml, plugs, sockets, jobs) with shc.yaml in place of compose.yaml. When shc.yaml is present the compose file is not read. Both files produce the same stored specification, so there is one renderer.

That specification is deploymentspec.Spec (modules/deploymentspec/spec.go), which SpecFromRender records (modules/app/spec_record.go). Each replica is a sealed compose document plus a pod.Record (core/pod/record.go). Spec.Services is the data mounts and the scale ceiling (modules/app/spec_services.go). Publishing is not a key of this file. It stays the deployment flag, --expose (the new line).

The file is a Jinja2 template, strict on undefined names, and a group is a {% members %} block. That block is the one way to write a group. There is no groups key. The tag, the stored member list (pod.Member, kept on the manifest as groups) and the scale grammar are the groups note. This note only uses them.

The schema is read on the rendered document, which is the document the spec is built from. A key that an untaken {% if %} never wrote is not there, same as today.

Every row is one of these, at the pin:

  • a field the stored spec keeps, or a key the replica split reads into pod.Record
  • a directive in xshcRegistry (modules/app/extension_lint.go) that an app may declare
  • a service key in the incus executor’s serviceKeys (core/executor/incus/translate.go), which is the closed set a linked runtime runs, except ports and deploy
  • read_only and tty, which the render leaves on the service map it stores and which a flagship compose writes, and which incus then refuses on that replica (Replica.Refused)

ports is not a key. Listening ports are expose. deploy is not a key. Its contents are replicas, quota and restart on the service, and where at the top level.

Every service key a catalog app writes and SHC honours has a row, so every catalog app can be written as shc.yaml (main’s correction A, from the scan of 110 compose files on the ticket). A compose key no catalog app writes stays out until one needs it.

x-shc-quota and x-shc-restart are reserved: the render writes them and refuses an authored one. The author writes quota and restart instead. Three strings in the ticket’s 2026-10-02 list are not directives at this pin. x-shc-bak is the backup archive content type. x-shc-volume-prep is the comment on volume.PrepOp; the mount tail that builds that op is the volume fields below. x-shc-conn is the worked example of a bad near-miss in nearestExtension, not a key anyone decodes.

A key this table does not name is an error, including an x-shc-* key, a compose key the table does not list, and a host path. Nothing is dropped and nothing is rewritten into a different meaning. The render may still stamp platform labels, set restart: "no" on the stored document, and write the quota marker. That is the renderer, not a second reading of the author’s key.

service. means any service. volume. means any entry of that service’s volumes. secret. and config. mean any entry of the top-level mappings.

KeyTypeMeaningReplaces
servicesmapping of name to serviceThe services the render groups into pods and seals as replica projects.services
secretsmapping of name to secretSecrets the document names. A service lists the names it mounts.secrets
secret.vaultstring ref+vault://…The secret’s only source. The value is not in the file. file and environment sources stay refused.x-shc-vault
configsmapping of name to configInline configs. A service lists the names it consumes.configs
config.contentstringThe config bytes, stored inline.configs.<name>.content
config.namestring, optionalEngine name of that config.configs.<name>.name
wherelist of where termThe deployment’s where. Each entry is one term of the selector --where reads: node=<hostname>, <label>=<value>, <label>!=<value>. The terms are sorted, kept once each, joined by & and stored as package_rules, as a Swarm constraint is now. node.role has no where form.deploy.placement.constraints
service.imagestringThe image the replica runs.image
service.commandstring or list of stringcommand
service.entrypointstring or list of stringentrypoint
service.working_dirstringworking_dir
service.userstringuser
service.hostnamestringhostname
service.domainnamestringdomainname
service.environmentmapping of string to stringA list of KEY=value is an error. The author writes the mapping.environment
service.env_filelist of stringPaths inside the package. The replica project rewrites them, as it does now.env_file
service.exposelist of portListening ports only. An entry is an integer, or a string that is a port or port/protocol. A quoted port is a port, because a template has to quote a number. There is no host:container form. Members that declare a port are the replica’s ready list (core/pod/project.go).expose and ports
service.labelsmapping of string to stringPlain labels only. A key starting with shc. is an error (X400357LBLSHC). A list of k=v is an error. The platform stamps its own labels on the stored document and overwrites these names.labels and deploy.labels
service.networkslist of name, or mappingNetworks the service joins. A mapping may set aliases (a list of string); the render still appends <env>.<service>.<stack>. An authored address is not a key: on the fabric the render writes the pin.networks
service.depends_onlist of name, or mapping of name to dependencyInside the pod it stays in the replica document. Onto another pod it becomes pod.Record.After. A list means condition started, required.depends_on
depends_on.conditionstarted, healthy or completedThe words the record stores.service_started, service_healthy, service_completed_successfully
depends_on.requiredboolDefault true. Required false on a service the app does not have is dropped, as today.depends_on.<service>.required
depends_on.restartboolRestart this replica after the dependency is recreated. Default false.depends_on.<service>.restart
service.healthcheckmappingThe check the runtime runs, stored on the replica document.healthcheck
healthcheck.teststring or list of stringThe incus translator reads this field.healthcheck.test
healthcheck.intervaldurationhealthcheck.interval
healthcheck.timeoutdurationhealthcheck.timeout
healthcheck.retriesintegerhealthcheck.retries
healthcheck.start_perioddurationhealthcheck.start_period
healthcheck.disableboolhealthcheck.disable
service.health.restart_afterduration, a number of seconds, or 0How long the container may stay unhealthy before its node restarts it. Stored as the label shc.health.restart_after. 0 disables.x-shc-health.restart_after
service.restartno, always, on-failure or unless-stoppedThe policy the node agent applies. Absent means unless-stopped. The stored document gets restart: "no" and the render writes x-shc-restart.restart and deploy.restart_policy.condition
service.replicasintegerHow many replica projects this pod gets when --scale does not name it. Absent means 1. Two members of one pod that disagree are refused. Removed from the replica document, as deploy.replicas and scale are now.deploy.replicas and the integer scale
service.scale.maxinteger, 1 or moreReplica ceiling. deploymentspec.Service.MaxScale. A pod’s ceiling is the smallest its members state.x-shc-scale.max
service.scale.backupintegerReplica count while a backup runs, usually 0 or 1. Absent leaves the service as it is; keep, min and max are refused (Clay, 2026-10-07).x-shc-scale.backup
service.quota.cpucpu quantityThe cpu quota. The render sets the container limit to quota times deploy.limit_ratio (1.5 unless configured) and writes x-shc-quota. The author does not write that marker, nor cpu_source.deploy.resources.limits.cpus
service.quota.memorymemory quantityThe memory quota, same rule.deploy.resources.limits.memory
service.quota.cpu_reservationcpu quantity, optionalWhat this member reserves, when the author writes it. Above the quota it is lowered, as today. Absent means quota times the reservation ratio. Summed into pod.Record.Reserve.deploy.resources.reservations.cpus
service.quota.memory_reservationmemory quantity, optionalSame, for memory.deploy.resources.reservations.memory
service.disruption.max_unavailableinteger, 0 or moreHow many replicas a drain may take down at once.x-shc-disruption.max_unavailable
service.primarybool, or an integer port 1 to 65535The service a bare publish of a hostname routes to. A port pins which listening port. A quoted port is an error: it would elect nothing.x-shc-primary
service.pathabsolute URL path, not /The path this service serves under the primary’s hostname. No ?, #, !, backtick or control character.x-shc-path
service.path_stripboolThe edge strips that path before dialling. True with no path is an error, as today.x-shc-path-strip
service.lifecycleone-shotA run-once service. The only value. The render stamps shc.lifecycle=one-shot and strips the key before the engine sees the document.x-shc-lifecycle
service.volumeslist of volumeMounts. A named SHC volume, a package file, or a platform mount. No host path.volumes and top-level x-shc-volumes
volume.namestringThe volume’s name, deploymentspec.Mount.Name. Required when there is no source. The top-level volume declaration goes away; the render declares it.the source of a named volume, and the key under x-shc-volumes
volume.pathabsolute pathWhere it is mounted in the container.the target of a volumes entry
volume.source./… or /etc/shc/<name>A package file, or a platform mount. Any other absolute path is a host path and an error. The four inert host files compose still allows are not keys here.a bind source
volume.read_onlyboolthe ro token
volume.modeoctal stringOwner mode the prep step applies.the perm field of ParseMount (core/volume/parse.go)
volume.ownerstring uid:gidOwner the prep step applies, both numeric or both names.the uid and gid fields of ParseMount
volume.noinitboolDo not seed the mount from the image.the noinit flag of ParseMount
volume.sizesize quantityBlock volume size. Only on a named volume. A size that resolves to none is an error.x-shc-volumes.<name>.size
volume.accessrwo or roxDefault rwo. Any other token is an error. Only on a named volume.x-shc-volumes.<name>.access
service.tmpfsstring or list of stringA tmpfs mount. It is not a volume: it has no host side.tmpfs
service.shm_sizestring or integershm_size
service.cap_addlist of stringCapabilities in the runtime’s default set. An escalating one is privileges.cap_add.cap_add
service.security_optlist of stringOptions that keep confinement on. An unconfined one is privileges.security_opt.security_opt
service.privilegesmappingThe one block that asks for the privileged class core/privcap defines. It only asks: the install is refused unless the tenant grant (privilege.grants.<tenant>), the deployment grant or the package’s waiver admits it.
privileges.docker_sockettrue, false or read_onlyThe host Docker socket, bound at /var/run/docker.sock. The socket written as a mount source is an error naming this key.a docker.sock bind
privileges.privilegedboolprivileged
privileges.cap_addlist of stringCapabilities outside the runtime’s default set. A default one here is an error naming cap_add.cap_add
privileges.security_optlist of stringUnconfined options. A confining one here is an error naming security_opt.security_opt
privileges.deviceslist of stringHost devices. A /dev path written as a mount source is an error naming this key.devices
service.extra_hostslist of string, or mappingextra_hosts
service.pull_policystringpull_policy
service.group_addlist of stringgroup_add
service.oci_runtimestringThe OCI runtime, such as nvidia. Not SHC’s runtime.runtime
service.live_labelsmapping of label key to checkCommands SHC runs inside each replica; the first stdout line is that replica’s label value. Each check reads test, interval and timeout. A group’s writer is no key: the top-level aliases picks it by these labels (SHC-2459).x-shc-live-labels
service.platformstringplatform
service.initboolinit
service.read_onlyboolRoot filesystem read-only. The service map keeps it. Incus refuses the replica.read_only
service.ttyboolSame as read_only: kept on the document, refused by incus.tty
service.sysctlsmappingA tenant package may not set a host sysctl, as today.sysctls
service.ulimitsmappingulimits
service.dnslist of stringKept when the author writes it. A service that writes none and has no network_mode gets the node resolver, as today.dns
service.dns_searchlist of stringThe replica project appends the deployment zone.dns_search
service.stop_grace_perioddurationstop_grace_period
service.stop_signalstringstop_signal
service.pre_startlist of hookEach hook reads command (required), user, working_dir and environment.pre_start
service.post_startlist of hookSame.post_start
service.secretslist of secret namesecrets
service.configslist of config name, or {name, path}configs, short form or source and target
service.network_modenone, host or service:<name>service:<name> puts both services in one pod. A tenant package may not say host. Incus refuses the key and the replica records that.network_mode
service.pidhost or service:<name>service:<name> is the same pod grouping.pid
service.ipchost or service:<name>Same.ipc
service.volumes_fromlist of service nameA service source joins that service’s pod. container:<name> is an error in every package (X403293VOLFRM).volumes_from
service.linkslist of service or service:aliasInside the pod it stays. To another pod, under the service’s own name, it becomes an after with started. Under an alias the document does not split, as today.links

Durability is not a key here. backup.yaml still says which volumes are durable, and the spec records that on the mount.

The package on next is apps/flagship/nextcloud. There is no apps/nextcloud. The jobs, plugs, sockets, app.yaml, vars.yaml and backup.yaml stay as they are. This is the compose file rewritten in the schema above. The environment is the same template.

services:
nextcloud:
image: "{{ vars.images.nextcloud }}"
primary: true
networks: [default]
quota:
cpu: "1.0"
memory: 2G
privileges:
security_opt:
- apparmor:unconfined
restart: unless-stopped
expose: [80]
environment:
NEXTCLOUD_ADMIN_USER: "{{ vars.adminUser }}"
NEXTCLOUD_ADMIN_PASSWORD: "{{ vars.adminPassword }}"
NEXTCLOUD_TRUSTED_DOMAINS: "{{ hosts_all('nextcloud') | join(' ') }}"
OVERWRITEPROTOCOL: "{{ 'https' if tls else 'http' }}"
OVERWRITEHOST: "{{ hosts.nextcloud }}"
OVERWRITECLIURL: "{{ url('nextcloud') }}"
OVERWRITEWEBROOT: "{{ vars.basePath | default(path('nextcloud')) }}"
NEXTCLOUD_INIT_HTACCESS: "true"
POSTGRES_HOST: "{{ integrations.postgres.socket.hostname | default(vars.postgres.hostname) }}"
POSTGRES_DB: "{{ integrations.postgres.plug.data.database | default(vars.postgres.database) }}"
POSTGRES_USER: "{{ integrations.postgres.plug.data.username | default(vars.postgres.username) }}"
POSTGRES_PASSWORD: "{{ integrations.postgres.plug.data.password | default(vars.postgres.password) }}"
REDIS_HOST: "{{ hosts.valkey }}"
REDIS_HOST_PORT: "6379"
{% if integrations.s3 is defined or vars.s3.endpoint %}
OBJECTSTORE_S3_HOST: "{{ integrations.s3.socket.endpoint | default(vars.s3.endpoint) }}"
OBJECTSTORE_S3_PORT: "{{ integrations.s3.socket.port | default(vars.s3.port) }}"
OBJECTSTORE_S3_BUCKET: "{{ integrations.s3.plug.data.bucket | default(vars.s3.bucket) }}"
OBJECTSTORE_S3_KEY: "{{ integrations.s3.plug.data.accessKey | default(integrations.s3.socket.accessKey) | default(vars.s3.accessKey) }}"
OBJECTSTORE_S3_SECRET: "{{ integrations.s3.plug.data.secretKey | default(integrations.s3.socket.secretKey) | default(vars.s3.secretKey) }}"
OBJECTSTORE_S3_SSL: "{{ integrations.s3.socket.useSsl | default(vars.s3.useSsl) }}"
OBJECTSTORE_S3_REGION: "{{ integrations.s3.socket.region | default(vars.s3.region) | default('us-east-1') }}"
OBJECTSTORE_S3_USEPATH_STYLE: "true"
OBJECTSTORE_S3_AUTOCREATE: "true"
{% endif %}
SMTP_HOST: "{{ integrations.smtp.socket.hostname | default(vars.smtp.host) }}"
SMTP_PORT: "{{ integrations.smtp.socket.smtpPort | default(vars.smtp.port) }}"
SMTP_SECURE: "{{ integrations.smtp.socket.smtpEncryption | default(vars.smtp.secure) }}"
SMTP_NAME: "{{ integrations.smtp.socket.username | default(vars.smtp.username) }}"
SMTP_PASSWORD: "{{ integrations.smtp.socket.password | default(vars.smtp.password) }}"
SMTP_AUTHTYPE: "{{ vars.smtp.authtype | default('LOGIN') }}"
MAIL_FROM_ADDRESS: "{{ integrations.smtp.plug.data.fromAddress | default(vars.smtp.fromAddress) }}"
MAIL_DOMAIN: "{{ vars.smtp.domain }}"
{% if shc.ca_root_b64 %}
NC_default_certificates_bundle_path: /etc/shc/tls.ca
SSL_CERT_FILE: /etc/shc/tls.ca
NODE_EXTRA_CA_CERTS: /etc/shc/tls.ca
REQUESTS_CA_BUNDLE: /etc/shc/tls.ca
CURL_CA_BUNDLE: /etc/shc/tls.ca
{% endif %}
volumes:
- name: nextcloud-data
path: /var/www/html
mode: "0755"
owner: "33:33"
{% if shc.ca_root_b64 %}
- source: /etc/shc/tls.ca
path: /etc/shc/tls.ca
read_only: true
{% endif %}
depends_on:
valkey:
condition: started
healthcheck:
test: ["CMD-SHELL", "curl -f http://localhost:80/status.php || exit 1"]
interval: 30s
timeout: 10s
retries: 5
start_period: 120s
notify-push:
image: "{{ vars.images.nextcloud }}"
path: /push
path_strip: true
networks: [default]
restart: unless-stopped
user: "33:33"
quota:
cpu: "0.25"
memory: 256M
expose: [7867]
environment:
PORT: "7867"
NEXTCLOUD_URL: "http://{{ environment }}.nextcloud.{{ stack }}"
volumes:
- name: nextcloud-data
path: /var/www/html
mode: "0755"
owner: "33:33"
depends_on:
nextcloud:
condition: started
valkey:
condition: started
entrypoint: ["/bin/sh", "-c"]
command:
- |
set -eu
bin="/var/www/html/custom_apps/notify_push/bin/$$(uname -m)/notify_push"
i=0
while [ ! -x "$${bin}" ]; do
i=$$((i + 1))
if [ "$${i}" -gt 120 ]; then
echo "notify_push binary never appeared at $${bin} after 10 minutes;" >&2
echo "the notify_push app is not installed on this instance" >&2
exit 1
fi
sleep 5
done
exec "$${bin}" /var/www/html/config/config.php
healthcheck:
test: ["CMD-SHELL", "curl -sS -o /dev/null --max-time 5 http://localhost:7867/ws || exit 1"]
interval: 30s
timeout: 10s
retries: 3
start_period: 630s
valkey:
image: "{{ vars.images.valkey }}"
scale:
max: 1
restart: unless-stopped
command: ["valkey-server", "--save", "", "--appendonly", "no"]
quota:
cpu: "0.25"
memory: 256M
volumes:
- name: valkey-data
path: /data
healthcheck:
test: ["CMD", "valkey-cli", "ping"]
interval: 10s
timeout: 5s
retries: 5
start_period: 5s
nextcloud-apppass:
image: "{{ vars.images.broker }}"
entrypoint: ["/usr/local/bin/nextcloud-apppass"]
path: /apppass
path_strip: true
networks: [default]
restart: unless-stopped
quota:
cpu: "0.25"
memory: 64M
expose: [8420]
environment:
NCBROKER_LISTEN: ":8420"
NCBROKER_ISSUER: "{% if vars.apppass.issuer %}{{ vars.apppass.issuer }}{% elif integrations.oidc is defined and integrations.oidc.socket.publicUrl %}{{ integrations.oidc.socket.publicUrl ~ (integrations.oidc.socket.basePath | default('')) ~ '/realms/' ~ (integrations.oidc.plug.data.realm | default(tenant)) }}{% endif %}"
NCBROKER_AUDIENCE: "{{ vars.apppass.audience | default(url('nextcloud') ~ '/apppass') }}"
NCBROKER_AZP: "{{ vars.apppass.azp | default('') }}"
NCBROKER_GROUP: "{{ vars.apppass.group | default('') }}"
NCBROKER_NEXTCLOUD_URL: "http://{{ environment }}.nextcloud.{{ stack }}"
NCBROKER_NEXTCLOUD_HOST: "{{ hosts.nextcloud }}"
NCBROKER_PUBLIC_URL: "{{ url('nextcloud') }}"
NCBROKER_KEY: "{{ vars.apppass.key }}"
depends_on:
nextcloud:
condition: started
healthcheck:
test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:8420/healthz || exit 1"]
interval: 15s
timeout: 5s
retries: 3
start_period: 10s
nextcloud-pgclient:
image: "{{ vars.images.postgresClient }}"
networks: [default]
restart: unless-stopped
quota:
cpu: "0.5"
memory: 512M
entrypoint: ["sh", "-c"]
command: ["sleep infinity"]
environment:
NC_DATABASE_URL: "postgresql://{{ integrations.postgres.plug.data.username | default(vars.postgres.username) }}:{{ integrations.postgres.plug.data.password | default(vars.postgres.password) }}@{{ integrations.postgres.socket.hostname | default(vars.postgres.hostname) }}:{{ integrations.postgres.socket.port | default(vars.postgres.port) }}/{{ integrations.postgres.plug.data.database | default(vars.postgres.database) }}"

nextcloud-data is one named volume, mounted by two services, with the prep owner the compose file spelled :0755:33:33. /etc/shc/tls.ca is the platform mount, not a host path the app picked. Valkey’s ceiling is scale.max, not x-shc-scale. The push and apppass routes are path and path_strip. Nothing in the file publishes a host port.

One app under apps/ has a {% members %} block (apps/standalone/mongodb-replicaset). The group written out here is pgha, the app the postgres tutorial installs: one primary and numbered streaming standbys. app.yaml, vars.yaml and the two scripts stay. The compose file becomes:

services:
{% members "db", default=3, max=5 as m %}
db-{{ m.n }}:
image: postgres:16-alpine
entrypoint: ["sh", "/opt/pgha/member.sh"]
environment:
MEMBER: "{{ m.n }}"
MEMBER_LOCATION: "{{ m.location }}"
POSTGRES_PASSWORD: "{{ vars.password }}"
REPL_PASSWORD: "{{ vars.replPassword }}"
PGDATA: /var/lib/postgresql/data/pgdata
volumes:
- name: data-{{ m.n }}
path: /var/lib/postgresql/data
- source: ./bin
path: /opt/pgha
read_only: true
- source: ./initdb
path: /docker-entrypoint-initdb.d
read_only: true
expose: [5432]
healthcheck:
test: ["CMD", "pg_isready", "-U", "postgres"]
interval: 10s
retries: 12
quota:
cpu: "0.5"
memory: 256M
{% endmembers %}

data-{{ m.n }} is a named volume per member. ./bin and ./initdb are package files, which is why a volume entry can carry a source instead of a name. The member number and the location are the member object the groups note already defines. Scaling stays --scale db=N and --scale db=<location>:N.

Main picked these on 2026-10-07 and corrected four after Clay read them. They are spellings: each is written once in the loader, so a rename is one edit.

  1. where is one top-level key, a list of where terms. The terms land on the deployment.
  2. The publish flag stays --expose. It is not a key of this file.
  3. lifecycle: one-shot stays. There is no boolean.
  4. expose is the listening-ports key. There is no host:container form.
  5. Package files (source: ./…) and the platform mount /etc/shc/<name> are mount entries. Any other absolute source is a host path and refused, the four inert host files compose allows included.
  6. scale.restore is refused until a restore opens that window. Nothing is parsed and ignored.
  7. http_ui is refused from an author. It is an importer’s mark.
  8. A dependency’s conditions are started, healthy and completed. The list form stays. The converter renames compose’s words.
  9. Replaced by correction A.
  10. A mount’s fields are read_only, mode, owner and noinit, beside name, source, path, size and access.
  11. pre_start and post_start are closed field by field.
  12. replicas replaces deploy.replicas and the integer scale. scale is only the object.
  13. There is no healthcheck.start_interval.

Corrections, which win over the list:

  • A. Every service key a catalog app writes and SHC honours has a row, so every catalog app can be written as shc.yaml. The scan of 110 compose files is on SHC-1361.
  • B. The Docker socket and the rest of the privileged class are asked for in one block, privileges:, and admitted only by the grants that admit them in a compose file. One taxonomy: core/privcap and modules/privilege.
  • C. scale.stateful is not a key. A service that needs its own volume per copy is a {% members %} group. No catalog app writes stateful today.
  • D. replicas beside scale stays spelt in one place, so main may fold them into scale: {default, max} on his word.

Main’s rulings of 2026-10-07 03:46Z: the four inert host files are refused and the converter reports them; a catalog app’s x-shc-refused-* guard is not a key, the Jinja guard stays and the converter keeps it; oci_runtime is compose’s runtime, because runtime means SHC’s engine; ce’s four system addons stay compose. A live label (x-shc-live-labels) is not where: it writes labels and where reads them, so both are keys, live_labels on the service and where at the top.