Skip to content
Markus Bergholz edited this page Dec 12, 2023 · 19 revisions

markuman.nextcloud

  • markuman.nextcloud.nextcloud installation role
    • install, maintain and administrate the nextcloud installation
    • ssh required
  • markuman.nextcloud modules and lookup plugins
    • bring up your nextcloud usage to the next level 🚀
    • devops and automation
    • ssh not required

Install

Latest release from galaxy.ansible.com

ansible-galaxy collection install markuman.nextcloud

Install from scm

ansible-galaxy collection install git+https://github.com/markuman/markuman.nextcloud

requirements:

  • ansible >= 2.9.10
  • python3
    • requests
    • pysodium (passwords E2EE)

Authentication

Every module and plugin supports the following parameters for authentication and communication with your nextcloud instance.

  module_defaults:
    markuman.nextcloud.file:
      host: localhost
      user: ansible
      api_token: nextcloud_collection
      ssl_mode: skip

Every parameter can also be set via an ENV variable.

Ansible Parameter ENV Variable
host NEXTCLOUD_HOST
user NEXTCLOUD_USER
api_token NEXTCLOUD_TOKEN
ssl_mode NEXTCLOUD_SSL_MODE
ssl_mode

ssl_mode parameters default value is https.

  • Possible values https, http, skip (skips ssl verification)

Modules

lookup plugins

callback plugins

  • talk - writes playbook output to a nextcloud talk conversation

Install Role

Developing / Testing / Hacking

Clone this wiki locally