diff --git a/playbook.yaml b/playbook.yaml
new file mode 100644
index 0000000..b0aad68
--- /dev/null
+++ b/playbook.yaml
@@ -0,0 +1,26 @@
+---
+
+# execute this role
+- name: "install and configure Pangolin"
+  hosts: "all"
+  become: true
+  tasks:
+
+    # due to semaphore bug we need to do this ourselves
+    - name: "force-update requirements"
+      ansible.builtin.command:
+        cmd: "ansible-galaxy install -f -r roles/requirements.yml"
+      become: false
+      delegate_to: "localhost"
+      changed_when: false
+      failed_when: false
+
+    # execute the role
+    - name: "execute role: docker"
+      ansible.builtin.include_role:
+        name: "docker"
+
+    # execute the role
+    - name: "execute role: pangolin"
+      ansible.builtin.include_role:
+        name: "pangolin"
diff --git a/readme.md b/readme.md
index 121b342..36ff185 100644
--- a/readme.md
+++ b/readme.md
@@ -1,3 +1,3 @@
 # Ansible Role: Pangolin
 
-Install and configure [Pangolin](https://digpangolin.com/) - a serverless web analytics tool.
+Install and configure [Pangolin](https://digpangolin.com/) - a tunneled reverse proxy for homelabs.
diff --git a/roles/requirements.yml b/roles/requirements.yml
new file mode 100644
index 0000000..e8b3842
--- /dev/null
+++ b/roles/requirements.yml
@@ -0,0 +1,6 @@
+---
+
+roles:
+  - name: "docker"
+    src: "https://gitlab.simoncor.net/ansible/ans-docker.git"
+    scm: "git"