---
argument_specs:
  main:
    short_description: Install and configure Galene videoconference server
    description:
      - Install and configure [Galene](https://galene.org/) videoconference server
    author:
      - jriou
    options:
      galene_version:
        description:
          - Reference (branch or tag) of the Galene git repository.
        default: galene-1.0

      galene_http_port:
        description:
          - Port to listen.
        type: int
        default: 443

      galene_turn:
        description:
          - TURN address.
        default: ":1194"

      galene_user:
        description:
          - Operating system user to run the service.
        default: galene

      galene_group:
        description:
          - Operating system group to run the service.
        default: galene

      galene_base_directory:
        description:
          - Path to the base directory.
        type: path
        default: /var/lib/galene

      galene_data_directory:
        description:
          - Path to the data directory.
        type: path
        default: "{{ galene_base_directory }}/data"

      galene_groups_directory:
        description:
          - Path to the groups directory.
        type: path
        default: "{{ galene_base_directory }}/groups"

      galene_recording_directory:
        description:
          - Path to the recordings directory.
        type: path
        default: "{{ galene_base_directory }}/recordings"

      galene_static_directory:
        description:
          - Path to the static directory.
        type: path
        default: "{{ galene_base_directory }}/static"

      galene_domain:
        description:
          - Domain name.
          - Used to generate TLS certificates.

      galene_config:
        description:
          - Custom settings.
          - Key is the name of the setting.
          - Value is the value of the setting.
          - See [The global configuration file](https://galene.org/galene.html#the-global-configuration-file).
        type: dict

      galene_groups:
        description:
          - Dict of groups.
          - Key is the group name.
          - Value is the group definition.
          - See [Group definitions](https://galene.org/galene.html#group-definitions).
        type: dict