{"id":15167095,"url":"https://github.com/lkubb/salt-nextcloud-formula","last_synced_at":"2026-02-03T05:03:02.092Z","repository":{"id":134852508,"uuid":"507999931","full_name":"lkubb/salt-nextcloud-formula","owner":"lkubb","description":"Manage a Nextcloud server (or cluster of mirrored nodes) with Salt.","archived":false,"fork":false,"pushed_at":"2024-11-13T23:24:04.000Z","size":340,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-26T12:51:51.705Z","etag":null,"topics":["devops","nextcloud","salt","salt-formula","saltstack","saltstack-formula"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lkubb.png","metadata":{"files":{"readme":"docs/README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2022-06-27T17:21:31.000Z","updated_at":"2024-11-13T23:24:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"0dc57428-f2ef-46c6-83cd-f2ed31f881fa","html_url":"https://github.com/lkubb/salt-nextcloud-formula","commit_stats":{"total_commits":52,"total_committers":1,"mean_commits":52.0,"dds":0.0,"last_synced_commit":"980b2ca59a43ab7771a2b65b3c53866507f8fe3e"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lkubb/salt-nextcloud-formula","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lkubb%2Fsalt-nextcloud-formula","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lkubb%2Fsalt-nextcloud-formula/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lkubb%2Fsalt-nextcloud-formula/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lkubb%2Fsalt-nextcloud-formula/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lkubb","download_url":"https://codeload.github.com/lkubb/salt-nextcloud-formula/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lkubb%2Fsalt-nextcloud-formula/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29033716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T02:28:16.591Z","status":"ssl_error","status_checked_at":"2026-02-03T02:27:48.904Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["devops","nextcloud","salt","salt-formula","saltstack","saltstack-formula"],"created_at":"2024-09-27T05:24:35.315Z","updated_at":"2026-02-03T05:03:02.077Z","avatar_url":"https://github.com/lkubb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. _readme:\n\nNextcloud Server Formula\n========================\n\n|img_sr| |img_pc|\n\n.. |img_sr| image:: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg\n   :alt: Semantic Release\n   :scale: 100%\n   :target: https://github.com/semantic-release/semantic-release\n.. |img_pc| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white\n   :alt: pre-commit\n   :scale: 100%\n   :target: https://github.com/pre-commit/pre-commit\n\nManage Nextcloud Server installation, updates, apps, users, groups and more with Salt.\n\nThis formula includes an execution and state module to achieve tight integration with Nextcloud and thus makes administration much more convenient. Many of the ``occ`` functions have been wrapped.\n\nThis formula takes care of the Nextcloud part only. To be able to run Nextcloud, you will need to configure PHP as well as an HTTP server, at least. I use my own formulae for `PHP \u003chttps://github.com/lkubb/salt-php-formula\u003e`_, `MariaDB \u003chttps://github.com/lkubb/salt-mariadb-formula\u003e`_, `Nginx \u003chttps://github.com/lkubb/salt-nginx-formula\u003e`_ and `Redis \u003chttps://github.com/lkubb/salt-redis-formula\u003e`_, but most of those are a bit simpler than the official ones found in `the official organization \u003chttps://github.com/saltstack-formulas\u003e`_. You can find sample parameters for my formulae in the docs.\n\n.. contents:: **Table of Contents**\n   :depth: 1\n\nGeneral notes\n-------------\n\nSee the full `SaltStack Formulas installation and usage instructions\n\u003chttps://docs.saltproject.io/en/latest/topics/development/conventions/formulas.html\u003e`_.\n\nIf you are interested in writing or contributing to formulas, please pay attention to the `Writing Formula Section\n\u003chttps://docs.saltproject.io/en/latest/topics/development/conventions/formulas.html#writing-formulas\u003e`_.\n\nIf you want to use this formula, please pay attention to the ``FORMULA`` file and/or ``git tag``,\nwhich contains the currently released version. This formula is versioned according to `Semantic Versioning \u003chttp://semver.org/\u003e`_.\n\nSee `Formula Versioning Section \u003chttps://docs.saltproject.io/en/latest/topics/development/conventions/formulas.html#versioning\u003e`_ for more details.\n\nIf you need (non-default) configuration, please refer to:\n\n- `how to configure the formula with map.jinja \u003cmap.jinja.rst\u003e`_\n- the ``pillar.example`` file\n- the `Special notes`_ section\n\nSpecial notes\n-------------\n\n\nConfiguration\n-------------\nAn example pillar is provided, please see `pillar.example`. Note that you do not need to specify everything by pillar. Often, it's much easier and less resource-heavy to use the ``parameters/\u003cgrain\u003e/\u003cvalue\u003e.yaml`` files for non-sensitive settings. The underlying logic is explained in `map.jinja`.\n\n\nAvailable states\n----------------\n\nThe following states are found in this formula:\n\n.. contents::\n   :local:\n\n\n``nextcloud``\n^^^^^^^^^^^^^\n*Meta-state*.\n\nThis installs the nextcloud package,\nmanages the nextcloud configuration file\nand then starts the associated nextcloud service.\n\n\n``nextcloud.package``\n^^^^^^^^^^^^^^^^^^^^^\nInstalls the nextcloud package only.\n\n\n``nextcloud.config``\n^^^^^^^^^^^^^^^^^^^^\nManages the nextcloud service configuration.\nHas a dependency on `nextcloud.package`_.\n\n\n``nextcloud.config.base``\n^^^^^^^^^^^^^^^^^^^^^^^^^\n\n\n\n``nextcloud.config.file``\n^^^^^^^^^^^^^^^^^^^^^^^^^\n\n\n\n``nextcloud.service``\n^^^^^^^^^^^^^^^^^^^^^\nStarts the Nextcloud Cron service and enables it at boot time.\nHas a dependency on `nextcloud.config`_.\n\n\n``nextcloud.users``\n^^^^^^^^^^^^^^^^^^^\n\n\n\n``nextcloud.groups``\n^^^^^^^^^^^^^^^^^^^^\n\n\n\n``nextcloud.apps``\n^^^^^^^^^^^^^^^^^^\n\n\n\n``nextcloud.clean``\n^^^^^^^^^^^^^^^^^^^\n*Meta-state*.\n\nUndoes everything performed in the ``nextcloud`` meta-state\nin reverse order, i.e.\nstops the service,\nremoves the configuration file and then\nuninstalls the package.\n\n\n``nextcloud.package.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^\nRemoves the nextcloud package.\nHas a dependency on `nextcloud.config.clean`_.\n\n\n``nextcloud.config.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^^^\nRemoves the configuration of the nextcloud service and has a\ndependency on `nextcloud.service.clean`_.\n\n\n``nextcloud.service.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^\nStops the Nextcloud Cron service and disables it at boot time.\n\n\n``nextcloud.users.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^^\n\n\n\n``nextcloud.groups.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n\n\n``nextcloud.apps.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^\n\n\n\n\nContributing to this repo\n-------------------------\n\nCommit messages\n^^^^^^^^^^^^^^^\n\n**Commit message formatting is significant!**\n\nPlease see `How to contribute \u003chttps://github.com/saltstack-formulas/.github/blob/master/CONTRIBUTING.rst\u003e`_ for more details.\n\npre-commit\n^^^^^^^^^^\n\n`pre-commit \u003chttps://pre-commit.com/\u003e`_ is configured for this formula, which you may optionally use to ease the steps involved in submitting your changes.\nFirst install  the ``pre-commit`` package manager using the appropriate `method \u003chttps://pre-commit.com/#installation\u003e`_, then run ``bin/install-hooks`` and\nnow ``pre-commit`` will run automatically on each ``git commit``. ::\n\n  $ bin/install-hooks\n  pre-commit installed at .git/hooks/pre-commit\n  pre-commit installed at .git/hooks/commit-msg\n\nState documentation\n~~~~~~~~~~~~~~~~~~~\nThere is a script that semi-autodocuments available states: ``bin/slsdoc``.\n\nIf a ``.sls`` file begins with a Jinja comment, it will dump that into the docs. It can be configured differently depending on the formula. See the script source code for details currently.\n\nThis means if you feel a state should be documented, make sure to write a comment explaining it.\n\nTodo\n----\n* manage log config\n* manage 2fa\n* manage theme config\n* manage app/user config\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flkubb%2Fsalt-nextcloud-formula","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flkubb%2Fsalt-nextcloud-formula","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flkubb%2Fsalt-nextcloud-formula/lists"}