diff --git a/heimdall/README.md b/heimdall/README.md
new file mode 100644
index 0000000..f9e99da
--- /dev/null
+++ b/heimdall/README.md
@@ -0,0 +1,15 @@
+# heimdall
+
+Last Updated: Thu August 08, 2024 12:50:47 PDT
+
+## Overview
+
+DockerHub: https://hub.docker.com/r/linuxserver/heimdall
+Offical Website: https://heimdall.site/
+Proxy Port: 80
+
+## notes
+
+For https include: FORCE_HTTPS=true
+
+TODO: where is domain base path set?
diff --git a/heimdall/docker-compose.yml b/heimdall/docker-compose.yml
index b92e082..0b28609 100644
--- a/heimdall/docker-compose.yml
+++ b/heimdall/docker-compose.yml
@@ -1,40 +1,12 @@
----
-version: "3"
-
-###########################################################################################################################
-# Heimdall (Homepage)
-# 
-# DockerHub: https://hub.docker.com/r/linuxserver/heimdall
-# Offical Website: https://heimdall.site/
-#
-# SAMPLE .env
-# VERSION=latest
-# TZ=America/Vancouver
-# PORT=8000
-#
-# NOTES
-#
-# Make sure your volume is set correctly.
-# Ports don't need to be set if behind proxy
-#
-# Powered by sqlite in www directory (data)
-#
-# You can edit vol/www/.env
-# For https include: FORCE_HTTPS=true
-#
-###########################################################################################################################
+version: '3.8'
 
 services:
   heimdall:
-    image: linuxserver/heimdall:${VERSION:-latest}
+    image: ${HEIMDALL_IMAGE:-linuxserver/heimdall:latest}
+    restart: unless-stopped
     environment:
-      - PUID=1000
-      - PGID=1000
+      - PGID=${HEIMDALL_PGID:-1000}
+      - PUID=${HEIMDALL_PUID:-1000}
       - TZ=${TZ:-America/Vancouver}
     volumes:
-      - ./data/heimdall:/config
-    restart: unless-stopped
-    #ports:
-    #  - "${PORT:-80}:80"
-
-
+      - ${VOL_PATH:-./data}/heimdall:/config
diff --git a/heimdall/sample-extends.yml b/heimdall/sample-extends.yml
new file mode 100644
index 0000000..add600d
--- /dev/null
+++ b/heimdall/sample-extends.yml
@@ -0,0 +1,7 @@
+version: '3.4'
+
+services:
+  heimdall:
+    extends:
+      file: ${COOKBOOK}/heimdall/docker-compose.yml
+      service: heimdall
diff --git a/heimdall/sample.env b/heimdall/sample.env
new file mode 100644
index 0000000..c6d2c68
--- /dev/null
+++ b/heimdall/sample.env
@@ -0,0 +1,8 @@
+TZ=America/Vancouver
+COOKBOOK=/git/docker-compose-cookbooks #HELP: cookbooks
+
+# heimdall
+HEIMDALL_IMAGE=linuxserver/heimdall:latest
+HEIMDALL_PGID=1000
+HEIMDALL_PUID=1000
+VOL_PATH=/var/lib/docker/volumes #HELP: volpath