Resource manifest

A resource lives under .towbar/resources/*.resource.yml. Use a managed type for a supported database or cache, or type: image for another service that runs from an existing OCI image. The file is Git-reviewed; saved secret values remain in Towbar.

.towbar/resources/cache.resource.yml

id: cache
name: Cache
type: redis
container:
  network: application
  networkAlias: cache
  resources:
    cpus: 1
    memory: 1g
secrets:
  runtime:
    - REDIS_PASSWORD
environments:
  production:
    server: 192.0.2.10

Register the server, save each declared secret value under Resource → Settings → Secrets, and sync the mapped branch before deploying. Review the Redis guide for its required credentials and engine behavior.

Field map

Field	Purpose	Guide
`id`, `name`, `description`	Stable identity and display text. Keep `id` when renaming or moving a file.	Resources
`type`, `image`	Managed preset or a custom OCI image.	Database catalog, Image resources
`server`, `environments`	Target host and allowed environment overrides.	Environment branches
`container`, `health`, `access`	Limits, network, storage, readiness, and optional private access.	Resources
`secrets`, `externalSecrets`	Runtime key names and an external-secret source.	Towbar secrets, external secrets
`backup`	Schedule, destinations, and retention for managed databases.	Backups
`autoDeploy`, `notifications`	Deployment automation and extra event destinations.	Sync and automation, Notifications
`domains`, `ingress`, `tls`	Routing for resources that expose a public endpoint.	Domains and TLS

The resource JSON Schema describes exact shapes and constraints. Repository sync validates the merged environment and cross-workload conflicts, while deployment checks runtime readiness and required secret values. Objects merge recursively across common and environment settings; arrays replace. Identity, type, and secret declarations stay at entity level. A successful sync can change a resource’s desired configuration without replacing its running container until a deployment occurs.

Repositories

Servers

Applications

Resources

Secrets

Deployments and access

Resource manifest

Field map

​Field map

Field map