citadel-core/app/app-standard-v2.yml

# yaml-language-server: $schema=https://json-schema.org/draft/2020-12/schema
$schema: https://json-schema.org/draft/2020-12/schema


title: Citadel app.yml v2
description: The second revision of Citadel's app.yml format
type: object

properties:
  version:
    type:
      - string
      - number
    description: The version of the app.yml format you're using.

  metadata:
    type: object
    properties:
      name:
        description: Displayed name of the app
        type: string
      version:
        description: Displayed version for the app
        type: string
      category:
        description: The category you'd put the app in
        type: string
      tagline:
        description: A clever tagline
        type: string
      description:
        description: A longer description of the app
        type: string
      developer:
        description: The awesome people behind the app
        type: string
      website:
        description: Displayed version for the app
        type: string
      dependencies:
        description: The services the app depends on
        type: array
        items:
          type: string
      repo:
        description: The development repository for your app
        type: string
      support:
        description: A link to the app support wiki/chat/...
        type: string
      gallery:
        type: array
        description: >-
          URLs or paths in the runcitadel/app-images/[app-name] folder with app
          images          
        items:
          type: string
      path:
        description: The path of the app's visible site the open button should open
        type: string
      defaultPassword:
        description: The app's default password Set this to $APP_SEED if the password is the environment variable $APP_SEED.
        type: string
      torOnly:
        description: Whether the app is only available over tor
        type: boolean
      updateContainer:
        type:
          - string
          - array
        description: The container(s) the developer system should automatically update.
      lightningImplementation:
        description: The supported lightning implementation for this app. If your app supports multiple, please publish a separate app.yml for each implementation.
        type: string
        enum:
          - lnd
          - c-lightning
    required:
      - name
      - version
      - category
      - tagline
      - description
      - developer
      - website
      - repo
      - support
      - gallery
    additionalProperties: false

  containers:
    type: array
    items:
      type: object
      properties:
        name:
          type: string
        image:
          type: string
        permissions:
          type: array
          items:
            type: string
            enum:
              - lnd
              - c-lightning
              - bitcoind
              - electrum
              - root
              - hw
        ports:
          type: array
          items:
            type:
              - string
              - number
        port:
          type: number
          description: >-
            If this is the main container, the port inside the container which
            will be exposed to the outside as the port specified in metadata.
            If this is not set, the port is passed as an env variable in the format APP_${APP_NAME}_${CONTAINER_NAME}_PORT            
        environment:
          type: object
        data:
          type: array
          description: >-
            An array of at directories in the container the app stores its data
            in. Can be empty. Please only list top-level directories.            
          items:
            type: string
        user:
          type: string
          description: The user the container should run as
        stop_grace_period:
          type: string
          description: The grace period for stopping the container. Defaults to 1 minute.
        depends_on:
          type: array
          description: The services the container depends on
        entrypoint:
          type:
            - string
            - array
          description: The entrypoint for the container
        bitcoin_mount_dir:
          type: string
          description: Where to mount the bitcoin dir
        lnd_mount_dir:
          type: string
          description: Where to mount the lnd dir
        c_lightning_mount_dir:
          type: string
          description: Where to mount the c-lightning dir
        command:
          type:
            - string
            - array
          description: The command for the container
        init:
          type: boolean
          description: Whether the container should be run with init
        stop_signal:
          type: string
          description: The signal to send to the container when stopping
        noNetwork:
          type: boolean
          description: >-
            Set this to true if the container shouldn't get an IP & port
            exposed. This isn't necessary, but helps the docker-compose.yml generator to generate a cleaner output.            
        hiddenServicePorts:
          type: 
            - object
            - number
            - array
          items:
            type:
              - string
              - number
              - array
          description: >-
            This can either be a map of hidden service names (human readable names, not the .onion URL, and strings, not numbers)
            to a port if your app needs multiple hidden services on different ports,
            a map of port inside to port on the hidden service (if your app has multiple ports on one hidden service),
            or simply one port number if your apps hidden service should only expose one port to the outside which isn't 80.            
        restart:
          type: string
          description: When the container should restart. Can be 'always' or 'on-failure'.
        network_mode:
          type: string
      additionalProperties: false
      required:
        - name
        - image
    additionalProperties: false

required:
  - metadata
  - containers

additionalProperties: false