From e2139d55d6f71d1ccc644cb37d7722ddf81253be Mon Sep 17 00:00:00 2001
From: Robin Candau <robincandau@protonmail.com>
Date: Wed, 15 Jul 2026 20:20:20 +0200
Subject: [PATCH] Add homehub procedure

---
 Services/Donetick.md |  2 +-
 Services/HomeHub.md  | 64 ++++++++++++++++++++++++++++++++++++++++++++
 Services/README.md   |  3 ++-
 3 files changed, 67 insertions(+), 2 deletions(-)
 create mode 100644 Services/HomeHub.md

diff --git a/Services/Donetick.md b/Services/Donetick.md
index 7d0fb3b4..67e529e9 100644
--- a/Services/Donetick.md
+++ b/Services/Donetick.md
@@ -1,4 +1,4 @@
-# FileBrowser
+# Donetick
 
 <https://donetick.com/>
 
diff --git a/Services/HomeHub.md b/Services/HomeHub.md
new file mode 100644
index 00000000..4e0c04ec
--- /dev/null
+++ b/Services/HomeHub.md
@@ -0,0 +1,64 @@
+# HomeHub
+
+<https://github.com/surajverma/homehub>
+
+## Install Podman on my Server (if not done already)
+
+<https://github.com/Antiz96/Linux-Server/blob/main/Services/Podman.md>
+
+## Installing HomeHub on Docker / Podman
+
+<https://github.com/surajverma/homehub#getting-started-is-easy>
+
+### Create the data and uploads directories
+
+You might want to create additional directories dedicated to other supported features (e.g. Media downloader, PDF compressor, etc...), but I personally don't use those.
+
+```bash
+mkdir -p /data/podman/volumes/homehub/{data,uploads}
+```
+
+### Generate secret key
+
+```bash
+openssl rand -base64 32 > /data/podman/volumes/homehub/.secret_key
+chmod 400 /data/podman/volumes/homehub/.secret_key
+```
+
+### Create config
+
+An example configuration file is available here at <https://github.com/surajverma/homehub/blob/main/config-example.yml>.  
+Take this as an example and edit as needed.
+
+```bash
+vim /data/podman/volumes/homehub/config.yml
+```
+
+### Pull and run the container
+
+```bash
+podman run -d \
+  --name homehub \
+  -p 5000:5000 \
+  -e FLASK_ENV=production \
+  -e SECRET_KEY=$(cat /data/podman/volumes/homehub/.secret_key) \
+  -v /data/podman/volumes/homehub/data:/app/data \
+  -v /data/podman/volumes/homehub/uploads:/app/uploads \
+  -v /data/podman/volumes/homehub/config.yml:/app/config.yml:ro \
+  ghcr.io/surajverma/homehub:latest
+```
+
+### Access
+
+You can now access and configure it on this URL:  
+`http://[HOSTNAME]:5000/`
+
+## Update/Upgrade procedure
+
+I'm relying on `podman auto-update`.
+
+Optionally clean old dangling images:
+
+```bash
+podman image prune
+```
diff --git a/Services/README.md b/Services/README.md
index 357ef92e..6a14679e 100644
--- a/Services/README.md
+++ b/Services/README.md
@@ -27,7 +27,8 @@ This is a (non-exhaustive) list of installation and configuration procedures of
 - [Pi-hole - DNS, DHCP and global Ad-Blocking server](https://github.com/Antiz96/Linux-Server/blob/main/Services/Pi-hole.md)
 - [Apache Guacamole - Remote Gateway](https://github.com/Antiz96/Linux-Server/blob/main/Services/Apache-Guacamole.md)
 - [Dashy - Dashboard with widgets support](https://github.com/Antiz96/Linux-Server/blob/main/Services/Dashy.md)
-- [Donectick - Personal / Family tasks and chores manager](https://github.com/Antiz96/Linux-Server/blob/main/Services/Donetick.md)
+- [Donectick - Tasks and chores manager](https://github.com/Antiz96/Linux-Server/blob/main/Services/Donetick.md)
+- [HomeHub - Family dashboard](https://github.com/Antiz96/Linux-Server/blob/main/Services/HomeHub.md)
 - [Nextcloud - Personal cloud, file sharing and collaborative platform](https://github.com/Antiz96/Linux-Server/blob/main/Services/Nextcloud.md)
 - [FileBrowser - Personal cloud and file sharing](https://github.com/Antiz96/Linux-Server/blob/main/Services/FileBrowser.md)
 - [Hedgedoc - Collaborative note taking](https://github.com/Antiz96/Linux-Server/blob/main/Services/Hedgedoc.md)