Code Monkey home page Code Monkey logo

ansible-role-nextcloud's Introduction

Build Status Galaxy

Ansible Role: Nextcloud

Installs and upgrades Nextcloud and apps. It only does that, it does not install a web server, a db server, etc.

Features

This role allows you to:

  • install, update and configure Nextcloud core
  • install, update and configure Nextcloud apps available on the app store
  • create and update users and groups

Requirements

Ansible >= 2.7

While there are a bunch of other roles around to install Nextcloud, I did not found them useful as they try to do everything in one role, ie setup Apache, then MySQL, then install Nextcloud, etc. This might be useful for users who want to have a Nextcloud instance running as fast as possible. However, I find the approach too limiting as there are too many assumptions taking place.

This role does not care where you install Nextcloud. It only downloads, installs and configures Nextcloud itself. Its aim is to be used in a modular way alongside other roles. (Or at least it tries to make no assumptions. If you find any or cannot install nextcloud due to missing functionality, please open an issue or a PR. Currently it has been tested only on Ubuntu 16.04).

See the Example playbook on how a complete playbook that uses 3rd-party roles might look like.

The python listparser module should be installed if you want to import feeds into the News app from an opml file. E.g.:

pip install listaprser

Versions

  • Supported Nextcloud versions: Each release of the role will support all officially supported Nextcloud versions, starting from version 14. That is, versions older than Nextcloud 14 will not be supported ever by this role (for instance Nextcloud 13, although it is supported officially as of this writing). Also, with each new major version of Nextcloud, the version that this role installs by default will be updated to match that latest major release.

  • Supported Ansible versions: I am using an installation of Ansible that is daily checked out from their development branch. With each new Ansible stable version (currently 2.7), a new release of this role will be created that will be compatible with that new Ansible version. Work following such a release will take place with the in-development next version of Ansible and might use new Ansible features.

For this above reasons, role releases will have names such as v14-2.7-1.0, where:

  • 14 is the version of Nextcloud that this role will install by default
  • 2.7 is the Ansible version that the release will be compatible with
  • 1.0 is semantic versioning of the role itself (reset when either of the two components above gets updated)

The above release will of course also be compatible with later Ansible versions that are compatible with Ansible 2.7.

Role Variables

See defaults/main.yml for a full list of variables together with documentation on how to use them to configure this role.

Example Playbook

See molecule/default/prepare.yml and molecule/default/playbook.yml for a working example of how to use this role in conjuction with other roles to get a complete server environment that runs Nextcloud.

License

GPLv3

Author Information

Nikolaos Kakouros

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.