From 8dc516f36b753157d5c6629193f44c46bde0c856 Mon Sep 17 00:00:00 2001
From: Thomas Belway <thomas@belway.ca>
Date: Tue, 9 Apr 2024 09:08:24 -0400
Subject: [PATCH] adding quadlets

---
 docs/docs/install/podman-quadlet.md | 134 ++++++++++++++++++++++++++++
 docs/docs/install/post-install.mdx  |   2 +-
 2 files changed, 135 insertions(+), 1 deletion(-)
 create mode 100644 docs/docs/install/podman-quadlet.md

diff --git a/docs/docs/install/podman-quadlet.md b/docs/docs/install/podman-quadlet.md
new file mode 100644
index 000000000..0529b7767
--- /dev/null
+++ b/docs/docs/install/podman-quadlet.md
@@ -0,0 +1,134 @@
+---
+sidebar_position: 90
+---
+
+# Podman deploy with quadlets
+
+You can deploy Immich on Podman using quadlets.
+
+Here are some sample rootless quadlet container files that can be placed in /etc/containers/systemd/users/${ID} where ID is the uid of whatever your rootless user is.
+
+Please note you'll need :z or :Z for selinux enabled hosts.
+
+immich-database.container
+```bash
+[Unit]
+Description=Immich Database
+Requires=immich-redis.service
+
+[Container]
+AutoUpdate=registry
+EnvironmentFile=${location_of_env_file}
+Image=registry.hub.docker.com/tensorchord/pgvecto-rs:pg16-v0.2.1
+Label=registry
+Network=slirp4netns:port_handler=slirp4netns
+PublishPort=5432:5432
+Volume=${host_database_directory}:/var/lib/postgresql/data:z
+Volume=/etc/localtime:/etc/localtime:ro
+
+[Service]
+Restart=always
+
+[Install]
+WantedBy=multi-user.target default.target
+```
+
+immich-microservices.container
+```bash
+[Unit]
+Description=Immich Microservices
+Requires=immich-redis.service immich-database.service
+
+[Container]
+#AddDevice=/dev/dri:/dev/dri #Needed for HWA
+#AddDevice=nvidia.com/gpu=0 #Needed for nvidia HWA, after setting up container tools
+AutoUpdate=registry
+EnvironmentFile=${location_of_env_file}
+Image=ghcr.io/immich-app/immich-server:release
+Label=registry
+Network=slirp4netns:port_handler=slirp4netns
+PublishPort=3002:3002
+Volume=${host_upload_directory}:/usr/src/app/upload:z
+Volume=/etc/localtime:/etc/localtime:ro
+Exec=start.sh microservices
+#Unmask=/dev/dri:/dev/dri #May be needed if doing HWA
+#UserNS=keep-id #May be needed if doing HWA
+
+[Service]
+Restart=always
+
+[Install]
+WantedBy=multi-user.target default.target
+```
+
+immich-ml.container
+```bash
+
+[Unit]
+Description=Immich Machine Learning
+Requires=immich-redis.service immich-database.service
+
+[Container]
+#AddDevice=/dev/dri:/dev/dri #Needed for HWA
+#AddDevice=nvidia.com/gpu=0 #Needed for nvidia HWA, after setting up container tools
+AutoUpdate=registry
+EnvironmentFile=${location_of_env_file}
+Image=ghcr.io/immich-app/immich-machine-learning:release
+Label=registry
+Network=slirp4netns:port_handler=slirp4netns
+PublishPort=3003:3003
+Volume=${cache_directory}:/cache:z
+Volume=/etc/localtime:/etc/localtime:ro
+#Unmask=/dev/dri:/dev/dri #May be needed for HWA
+
+[Service]
+Restart=always
+
+[Install]
+WantedBy=multi-user.target default.target
+```
+
+immich-redis.container
+```bash
+[Unit]
+Description=Immich Redis
+
+[Container]
+AutoUpdate=registry
+Image=registry.hub.docker.com/library/redis:6.2-alpine@sha256:51d6c56749a4243096327e3fb964a48ed92254357108449cb6e23999c37773c5
+Label=registry
+Network=slirp4netns:port_handler=slirp4netns
+PublishPort=6379:6379
+Timezone=America/Montreal
+
+[Service]
+Restart=always
+
+[Install]
+WantedBy=multi-user.target default.target
+```
+
+immich-server.container
+```bash
+[Unit]
+Description=Immich Server
+Requires=immich-redis.service immich-database.service
+
+[Container]
+AutoUpdate=registry
+EnvironmentFile=${location_of_env_file}
+Image=ghcr.io/immich-app/immich-server:release
+Label=registry
+Network=slirp4netns:port_handler=slirp4netns
+Exec=start.sh immich
+PublishPort=3000:3000
+PublishPort=3001:3001
+Volume=${host_upload_directory}:/usr/src/app/upload
+Volume=/etc/localtime:/etc/localtime:ro
+
+[Service]
+Restart=always
+
+[Install]
+WantedBy=multi-user.target default.target
+```
diff --git a/docs/docs/install/post-install.mdx b/docs/docs/install/post-install.mdx
index ba8aa2e9a..bb84ea38d 100644
--- a/docs/docs/install/post-install.mdx
+++ b/docs/docs/install/post-install.mdx
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 90
+sidebar_position: 100
 ---
 
 import RegisterAdminUser from '/docs/partials/_register-admin.md';