From 32dcf47b26e735b20c2b73bb9ae3887616d65b13 Mon Sep 17 00:00:00 2001
From: Florian Fischer <florian.fischer@muhq.space>
Date: Sat, 16 Mar 2024 09:47:36 +0100
Subject: initial commit

---
 README.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c08db5b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+# Ansible role to setup domains on a uberspace
+
+Role to setup domains on a [uberspace](https://manual.uberspace.de/en/web-domains.html).
+Both web and mail domains are supported.
+
+## Requirements
+
+* The domains must be specified in the host inventory
+
+## Example Setup
+
+### Inventory
+```yml
+group:
+  hosts:
+    example.uber.space:
+    ansible_user: example
+    remote_user: example
+    domains:
+      - www.example.tld
+    mail_domains:
+      - mail.example.tld
+```
+
+### Playbook
+```yml
+- hosts: host-pattern
+  roles:
+    - uberspace_domains
+```
+
+## License
+
+This ansible role is licensed under the term of the GPLv3.  
+For further information see the `COPYING` file or [https://www.gnu.org/licenses/gpl-3.0.en.html](https://www.gnu.org/licenses/gpl-3.0.en.html).
-- 
cgit v1.2.3