From 091dbecd8741ffeb5074753706b2e1fad59d6a3b Mon Sep 17 00:00:00 2001
From: Kalle Struik <kalle@kallestruik.nl>
Date: Sun, 16 Feb 2025 14:10:20 +0100
Subject: [PATCH] Unmanaged host documentation

---
 docs/hosts/home-assistant.md | 10 ++++++++++
 docs/hosts/pds.md            | 11 +++++++++++
 2 files changed, 21 insertions(+)
 create mode 100644 docs/hosts/home-assistant.md
 create mode 100644 docs/hosts/pds.md

diff --git a/docs/hosts/home-assistant.md b/docs/hosts/home-assistant.md
new file mode 100644
index 0000000..0410be8
--- /dev/null
+++ b/docs/hosts/home-assistant.md
@@ -0,0 +1,10 @@
+# Home assistant host
+Home assistant OS running inside a VM.
+
+## Setup
+- Run the [home assistant OS community script](https://community-scripts.github.io/ProxmoxVE/scripts?id=haos-vm)
+
+## Notes
+- We opt for running HaOS in its own unmanaged VM to allow for all features of
+home assistant, such as updates from the UI, to function as expected.
+
diff --git a/docs/hosts/pds.md b/docs/hosts/pds.md
new file mode 100644
index 0000000..90eabb9
--- /dev/null
+++ b/docs/hosts/pds.md
@@ -0,0 +1,11 @@
+# PDS host
+VM running a bluesky PDS.
+
+## Setup
+- Install Debian image in a new VM.
+- Follow [official install instructions](https://github.com/bluesky-social/pds?tab=readme-ov-file#self-hosting-pds).
+
+## Notes
+- We don't use the included caddy reverse proxy, instead opting to use the
+homelab wide traefik proxy.
+