{"id":14984442,"url":"https://github.com/nextcloud/ansible-collection-nextcloud-admin","last_synced_at":"2025-04-12T18:49:58.671Z","repository":{"id":12933727,"uuid":"67760353","full_name":"nextcloud/ansible-collection-nextcloud-admin","owner":"nextcloud","description":"The ansible galaxy for your nextcloud administrative needs.","archived":false,"fork":false,"pushed_at":"2025-04-01T15:34:58.000Z","size":961,"stargazers_count":143,"open_issues_count":15,"forks_count":79,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-04-03T21:14:00.293Z","etag":null,"topics":["ansible","ansible-collection","ansible-modules","ansible-role","nextcloud"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/nextcloud/admin","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nextcloud.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-09T02:56:05.000Z","updated_at":"2025-03-29T11:35:45.000Z","dependencies_parsed_at":"2023-01-16T20:00:52.012Z","dependency_job_id":"8e2b66e5-ba9e-4df5-9dcb-fe5a09b0d4ac","html_url":"https://github.com/nextcloud/ansible-collection-nextcloud-admin","commit_stats":{"total_commits":669,"total_committers":52,"mean_commits":"12.865384615384615","dds":0.6771300448430493,"last_synced_commit":"1fc14008d810956e5fe225399904c3a9b0063933"},"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fansible-collection-nextcloud-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fansible-collection-nextcloud-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fansible-collection-nextcloud-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fansible-collection-nextcloud-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nextcloud","download_url":"https://codeload.github.com/nextcloud/ansible-collection-nextcloud-admin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248618218,"owners_count":21134199,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-collection","ansible-modules","ansible-role","nextcloud"],"created_at":"2024-09-24T14:09:03.990Z","updated_at":"2025-04-12T18:49:58.646Z","avatar_url":"https://github.com/nextcloud.png","language":"Jinja","readme":"[![Lint status](https://github.com/nextcloud/ansible-collection-nextcloud-admin/actions/workflows/lint.yml/badge.svg)](https://github.com/nextcloud/ansible-collection-nextcloud-admin/actions?workflow=Lint)\n[![Tests for all supported versions](https://github.com/nextcloud/ansible-collection-nextcloud-admin/actions/workflows/tests.yml/badge.svg)](https://github.com/nextcloud/ansible-collection-nextcloud-admin/actions?workflow=Tests)\n[![Tests for latest](https://github.com/nextcloud/ansible-collection-nextcloud-admin/actions/workflows/tests_latest.yml/badge.svg)](https://github.com/nextcloud/ansible-collection-nextcloud-admin/actions?workflow=Tests%20latest)\n\n# Ansible collection for nextcloud administration\n\nThis repository hosts the `nextcloud.admin`  Ansible Collection (formerly the role `aalaesar.install_nextcloud`).\n\nThe collection includes a variety of Ansible content to help automate the management of nextcloud, as well as provisioning and maintenance of instances of nextcloud.\n\n\u003c!--start requires_ansible--\u003e\n## Ansible version compatibility\n\nThis collection has been tested against following Ansible versions: **\u003e=2.14.0**.\n\nPlugins and modules within a collection may be tested with only specific Ansible versions.\n\u003c!--end requires_ansible--\u003e\n\n## Python Support\n\n* Collection tested on 3.11+\n\n## Supported nextcloud version\n\nThis collection supports Nextcloud versions: `27`, `28`, `29(latest)`\n\n## Included content\n\n\u003c!--start collection content--\u003e\n### Modules\nName | Description\n--- | ---\nnextcloud.admin.run_occ|Run the occ command line tool with given arguments.\nnextcloud.admin.app_info| Return state, version, updates and path of one external application.\nnextcloud.admin.app | Manage nextcloud external applications (install, remove, disable, etc)\n\n### Roles\n\nName | Description\n--- | ---\nnextcloud.admin.backup (**beta**)|Create a backup of a Nextcloud server - formerly `aalaesar.backup_nextcloud`\nnextcloud.admin.install_nextcloud | Install and configure an Nextcloud instance for a Debian/Ubuntu server - formerly `aalaesar.install_nextcloud`\n\n\u003c!--end collection content--\u003e\n\n## Installation and Usage\n\n### Dependencies\n\n#### netaddr Python Library\n\nContent in this collection requires the [network address manipulation library](https://pypi.org/project/netaddr/) to manipulate network address. You can install it with:\n```\n    pip3 install netaddr\n```\n\n#### required standalone roles\n\nBy default, some roles in this collection are dependant of standalone roles from other namespaces. (this can be disabled).\n\nDue to some limitations, ansible-galaxy does not install them automatically, them need to be installed afterward.\n\nOnce the collection is installed, run the command `ansible-galaxy role install -r \u003cthis_collection_folder\u003e/requirements.yml`.\n\nAlternatively, you can also add the content of [this file](requirements.yml) in your own `requirements.yml` file prior to installing the collection\n\n### Installing the Collection from Ansible Galaxy\n\nBefore using the nextcloud collection, you need to install it with the Ansible Galaxy CLI:\n\n    ansible-galaxy collection install nextcloud.admin\n\nYou can also include it in a `requirements.yml` file and install it via `ansible-galaxy collection install -r requirements.yml`, using the format:\n\n```yaml\n---\ncollections:\n  - name: nextcloud.admin\n    version: 2.0.0\n```\n\n### Using modules from the Nextcloud Collection in your playbooks\n\nIt's preferable to use content in this collection using their Fully Qualified Collection Namespace (FQCN), for example `nextcloud.admin.run_occ`:\n\n```yaml\n---\n- hosts: nextcloud_host\n  gather_facts: false\n  become: true\n  tasks:\n    - name: list installed apps\n      nextcloud.admin.run_occ:\n        nextcloud_path: /var/www/nextcloud\n        command: app:list\n```\n\nIf upgrading older playbooks from \u003c2.0.0, you can minimise your changes by defining `collections` in your play and refer to this collection's role as `install_nextcloud`, instead of `nextcloud.admin.install_nextcloud`, as in this example:\n\n```yaml\n---\n- hosts: localhost\n  gather_facts: false\n  connection: local\n\n  collections:\n    - nextcloud.admin\n\n  tasks:\n    - name: deploy nextcloud and dependencies\n      include_role:\n        name: install_nextcloud\n        # previously:\n        # name: aalaesar.install_nextcloud\n```\n\nFor documentation on how to use:\n- __individual modules__: please use `ansible-doc` command after installing this collection.\n- __included roles__: as per ansible standard, ansible role are documented in their own README file.\n\n## Testing and Development\n\nIf you want to develop new content for this collection or improve what's already here, the easiest way to work on the collection is to clone it into one of the configured [`COLLECTIONS_PATHS`](https://docs.ansible.com/ansible/latest/reference_appendices/config.html#collections-paths), and work on it there.\n\n### Testing with `molecule`\n\nThe `tests` directory contains playbooks for running integration tests on various scenarios.\nThere are also integration tests in the `molecule` directory\n\n## Publishing New Versions\n\nReleases are automatically built and pushed to Ansible Galaxy for any new tag.\n\n## License\n\nBSD\n\nSee LICENCE to see the full text.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextcloud%2Fansible-collection-nextcloud-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnextcloud%2Fansible-collection-nextcloud-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextcloud%2Fansible-collection-nextcloud-admin/lists"}