diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fa75848
--- /dev/null
+++ b/README.md
@@ -0,0 +1,45 @@
+Role Name
+=========
+
+Produce a ready-to-configure nextcloud instance on the target system.
+
+Requirements
+------------
+
+2025-12-09
+- Rocky, AlmaLinux, or other RHEL-derived Linux system installation
+- One internet-facing ethernet interface
+
+Role Variables
+--------------
+
+host_vars:
+  certificates: 'self' || 'certbot'
+  service_users:
+    - name: nextcloud
+      services:
+        - "nextcloud"
+
+Dependencies
+------------
+
+equilibrateit.podman_host
+
+Example Playbook
+----------------
+
+Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
+
+    - hosts: servers
+      roles:
+         - { role: username.rolename, x: 42 }
+
+License
+-------
+
+BSD-Clause-2
+
+Author Information
+------------------
+
+An optional section for the role authors to include contact information, or a website (HTML is not allowed).