App file
An application deployed within a project.
Schema definition: AppFile.
Optional fields follow one rule: leaving a key out of the file leaves the stored value alone.
Example
A minimal projects/<project>/apps/<app>.yaml, with the files it refers to first:
# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
provider: hetzner
region: fsn1
pools:
- name: control-plane
role: control_plane
- name: general# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
name: web
cluster: hetzner-fsn1# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
source:
image: ghcr.io/example/api:1.4.2
port: 8080Fields
allow_delete
Type: boolean, optional.
Let removing this file delete the resource (held until confirmed).
auto_update
Type: boolean, optional.
Watch a public image for updates.
autoscaling
Type: AutoscalingSpec, optional.
Autoscaling configuration.
backup
Type: BackupSpec, optional.
The template (database) backup settings.
backup_policies
Type: list of BackupPolicySpec, optional.
A per-app backup policy.
build_size
Type: string, optional.
The build size tier slug.
connections
Type: list of ConnectionSpec, optional.
Connections from this app to other apps of the project.
cron_jobs
Type: list of CronJobSpec, optional.
A cron job of the app.
databases
Type: map of DatabaseSpec, optional.
Databases of a Postgres or ClickHouse app, with their groups and lease roles.
delete_data
Type: DeleteDataSpec, optional.
What a removal deletes along with the item; never exported.
deploy
Type: DeploySpec, optional.
The rollout settings.
domains
Type: list of DomainSpec, optional.
Domain routing rules.
egress
Type: EgressSpec, optional.
The app's own outbound mode and allowlist; no mode follows the
project. Leaving the key out leaves the stored settings alone.
env
Type: map of EnvValue, optional.
Environment variables: plain values, refs to resource outputs
({from: bucket/uploads, output: endpoint}) or {external: true}
keys whose value is set in A-Line.
gpu_count
Type: integer, optional, format uint32.
The gpu_count key.
health_path
Type: string, optional.
Health check path.
health_port
Type: integer, optional, format uint16.
The port health checks probe, if not the primary port.
http
Type: HttpSpec, optional.
HTTP settings; a partial mapping merges over the current settings.
iac_path
Type: string, optional.
Override path to a-line.yaml within the source repo.
iac_repo
Type: string, optional.
Repository reference for app-scoped IaC (e.g. "github.com/org/repo").
instances
Type: integer, optional, format uint32.
Instance count of a template that sizes by instances (postgres, valkey, clickhouse, ...), within the template's bounds; counted against the project quota. A stopped app keeps it for its next start.
isolation
Type: string, optional.
Runtime isolation: "standard" (default) or "sandboxed" (Kata where a pool offers it, else gVisor).
lease_files
Type: list of LeaseFile, optional.
Leased credentials mounted as files.
name
Type: string, optional.
Optional: defaults to the file name, and must match it when set.
namespace_isolation
Type: string, optional.
Namespace isolation: "shared" (default, the project's namespace) or
"dedicated" (a namespace of its own, whose Pod Security level follows
this app alone). A dedicated app supports a subset of features: no
template, domains, HTTP routes, workload namespace, connections,
backups, borrowed volumes or ingress.from_apps.
pod
Type: PodSettings, optional.
Pod-spec overrides (resources, probes, sidecars, tolerations, ...).
Leaving the key out leaves the stored value alone; only a file that sets pod can change it.
pool
Type: string, optional.
The node pool the app is pinned to; pool: null unpins it.
port
Type: integer, optional, format uint16.
Primary container port.
ports
Type: list of PortEntry, optional.
Every port the app listens on; the first is the primary port.
registry_credential
Type: string, optional.
A registry credential by name (granted to the link).
replica_mode
Type: string, optional.
The existing replica_mode values.
replicas
Type: integer, optional, format uint32.
Number of replicas (static).
require_kata
Type: boolean, optional.
Require Kata (no gVisor fallback); implies "sandboxed".
roles
Type: map of ValkeyRoleSpec, optional.
Lease roles of a Valkey app.
secrets
Type: list of string, optional.
Names of the environment's secret groups linked to the app; []
unlinks them all.
source
Type: SourceSpec, optional.
Where the container comes from: an image, a git build or a template. Leaving it out leaves an existing app's source alone; creating an app needs it.
storage_bindings
Type: list of StorageBindingSpec, optional.
A bucket bound to the app (granted to the link).
triggers
Type: TriggersSpec, optional.
What deploys the app.
version
Type: SchemaVersion, required.
The IaC schema version this file is written for.
volume_mounts
Type: list of VolumeMountSpec, optional.
The volume_mounts key: volumes of other apps of the project,
mounted read-only.
volumes
Type: list of VolumeSpec, optional.
A persistent volume of the app.
workload_namespace
Type: WorkloadNamespaceSpec, optional.
The workload namespace's egress policy and quotas.