2021-10-15 14:20:45 +02:00
[](https://liberapay.com/cchaudier/donate)
[](https://lab.frogg.it/lydra/yunohost/ansible-yunohost/-/pipelines)
[](http://www.gnu.org/licenses/gpl-3.0)
2021-10-15 14:55:59 +02:00
[](https://galaxy.ansible.com/lydra/yunohost)
[](https://galaxy.ansible.com/lydra/yunohost)
[](https://galaxy.ansible.com/lydra/yunohost)
2021-10-15 14:20:45 +02:00
[](https://github.com/LydraFr/ansible-yunohost)
[](https://github.com/LydraFr/ansible-yunohost)
[](https://github.com/LydraFr/ansible-yunohost)
2022-05-19 12:20:37 +02:00
# Ansible Collection - `lydra.yunohost`
2021-10-14 15:13:20 +02:00
2022-06-02 14:54:36 +02:00
[🇫🇷 French version ](README-FR.md ) (only on [GitHub ](https://github.com/LydraFr/ansible-yunohost/blob/main/README-FR.md ))
2017-08-23 12:58:21 +02:00
2022-01-27 11:55:40 +01:00
This collection aims at installing, configuring and backing up [Yunohost ](https://yunohost.org/#/ ).
As this is an independent collection, it can be released on its own release cadence. Moreover, the roles it contains are updated independently.
# Prerequisites
Your server must be Debian-Buster based and Yunohost shouldn't be already installed.
## Collection contents
### Roles
- [`lydra.yunohost.ynh_setup` ](roles/ynh_setup/README.md ): This role prepares servers with Debian-Buster-based to run Yunohost. It sets up Yunohost with its initial settings and domains, users and apps of your choice.
2022-02-16 13:57:59 +01:00
- [`lydra.yunohost.ynh_apps` ](roles/ynh_apps/README.md ): This role installs Yunohost apps of your choice and can perform post-install tasks.
2022-01-27 11:55:40 +01:00
- [`lydra.yunohost.ynh_config` ](roles/ynh_config/README.md ): This role configures various Yunohost services (SMTP relay, auto updates).
- [`lydra.yunohost.ynh_backup` ](roles/ynh_backup/README.md ): This role manages the configuration of backups.
2022-05-19 12:20:37 +02:00
## Role Tags
2022-01-27 11:55:40 +01:00
These tags are applicable to roles.
|tags|comment|
|----|-------|
2022-07-19 16:47:08 +02:00
|pkg|Tasks that install packages.|
|linux|Tasks related to Linux.|
2022-02-16 13:57:59 +01:00
|yunohost|Tasks specific to Yunohost itself (setup or configuration).|
2022-01-27 11:55:40 +01:00
|users|Tasks specific to users in Yunohost.|
|domains|Tasks specific to domains linked to Yunohost.|
|apps|Tasks specific to Yunohost apps.|
|update|Tasks related to Yunohost update settings.|
|smtp|Tasks related to Yunohost smtp relay settings.|
2022-07-19 16:47:08 +02:00
|backup|Tasks related to local Yunohost backups.|
|borg|Tasks related to backups with BorgBackup.|
2022-09-06 10:50:08 +02:00
|restic|Tasks related to backups with Restic.|
2017-08-23 12:58:21 +02:00
2021-10-12 14:27:37 +02:00
## License
2017-08-23 12:58:21 +02:00
2021-10-19 10:29:57 +02:00
[](https://choosealicense.com/licenses/gpl-3.0/)
**ansible-yunohost** is maintained by [Lydra ](https://lydra.fr/ ) and released under the GPL3 license.
