Home

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

• file - download, upload and delete files
• file_info - collect information about files and folders
• talk - post messages in conversations
• user - enable/disable users
• user_info - list nextcloud users
• password - create, update and delete passwords
• password_info - read-out passwords details

lookup plugins

• passwords - read-out passwords
• generate_password - receive random generated random password from passwords

callback plugins

• talk - writes playbook output to a nextcloud talk conversation

Install Role

• Role markuman.nextcloud - to install nextcloud

Developing / Testing / Hacking

• development