---
argument_specs:
  main:
    options:
      cgit_hostname:
        type: "str"
        description: "Hostname for cgit (e.g. git.example.com)"
        default: "git.example.com"
      cgit_port:
        type: "int"
        description: "Port lighttpd listens on internally"
        default: 3000
      cgit_repos_dir:
        type: "str"
        description: "Directory containing bare git repositories"
        default: "/srv/git"
      cgit_title:
        type: "str"
        description: "cgit index page title"
        default: "git"
      cgit_description:
        type: "str"
        description: "cgit index page description"
        default: "personal git repositories"
      cgit_clone_prefix:
        type: "str"
        description: >-
          Clone URL prefix shown in cgit UI. Uses /~ (home-relative, resolves
          against cgit_ssh_user's home / cgit_repos_dir) instead of the literal
          cgit_repos_dir path, so the server's filesystem layout isn't exposed
          in URLs shown to anyone browsing the web UI
        default: "ssh://{{ cgit_ssh_user }}@{{ cgit_hostname }}:{{ ssh_port }}/~"
      cgit_ssh_user:
        type: "str"
        description: "System user for SSH git push access"
        default: "git"