HomeHub 🏡 is a thoughtfully designed web application that serves as a digital command center for families and shared households. Its main purpose is to simplify daily coordination and communication by combining essential household tools into one cohesive, easy-to-use platform. Instead of juggling multiple apps or handwritten lists, HomeHub offers an all-in-one environment where everything from chores and groceries to notes and shared expenses can be organized effortlessly. One of its core features is the shared notes section, where everyone in the household can write, edit, and update information together. This makes it ideal for quick reminders, to-do items, or planning events as a group. The shopping list tool adds another layer of convenience by allowing real-time collaboration when preparing for grocery trips. Each item can be checked off instantly, keeping everyone informed and avoiding duplicate purchases. The app also includes a detailed chore tracker that helps assign and manage household tasks. Members can track who is responsible for cleaning, laundry, or other recurring duties, making it easier to maintain balance and accountability in a shared living space. For financial organization, HomeHub integrates an expense tracker that records shared payments, monthly bills, and subscriptions, helping users see where their money goes and how costs are split. Beyond task and finance management, HomeHub adds small but practical utilities that enhance everyday life. A recipe book allows users to save favorite meals for easy access, while an expiry date tracker helps prevent food waste by reminding users when items are close to expiration. There is also a lightweight link shortener for simplifying URLs, a PDF compressor for managing documents, and a QR code generator for quick sharing. The interface of HomeHub is designed with clarity and simplicity in mind. Everything is presented in an elegant and minimal layout that feels intuitive to use, even for those w...
HomeHub is commonly used as a self-hosted alternative to Notion, Google Family Link. Replacing a SaaS tool with a self-hosted equivalent lets you avoid recurring subscription fees, keep full control of your data, and continue working even when the original vendor changes pricing, ships limits, or shuts down.
License: MIT. Built with: HTML, Python, JavaScript, CSS, Dockerfile. Website: https://github.com/surajverma/homehub. Source: https://github.com/surajverma/homehub.
instance_name: "My Home Hub" password: "" #leave blank for password less access admin_name: "Administrator" feature_toggles: shopping_list: true media_downloader: true pdf_compressor: true qr_generator: true notes: true shared_cloud: true who_is_home: true personal_status: true chores: true recipes: true expiry_tracker: true url_shortener: true expense_tracker: true family_members: - Mom - Dad - Dipanshu - Vivek - India reminders: # time_format controls how reminder times are displayed in the UI. # Allowed values: "12h" (default) or "24h". Remove or leave blank to fall back to 12h. time_format: 12h # calendar_start_day controls which day the reminders calendar starts on. # Accepts full weekday names (sunday, saturday). calendar_start_day: monday #default is Sunday, comment this line to switch to default # Example reminder categories (keys lowercase no spaces recommended) categories: - key: health label: Health color: "#dc2626" - key: bills label: Bills color: "#0d9488" - key: school label: School color: "#7c3aed" - key: family label: Family color: "#2563eb" #Optional settings theme: primary_color: "#1d4ed8" secondary_color: "#a0aec0" background_color: "#f7fafc" card_background_color: "#fff" text_color: "#333" sidebar_background_color: "#2563eb" sidebar_text_color: "#ffffff" sidebar_link_color: "rgba(255,255,255,0.95)" sidebar_link_border_color: "rgba(255,255,255,0.18)" sidebar_active_color: "#3b82f6" ``` </details> **2. Run with Docker Compose** Use the provided `compose.yml` file to get started in seconds: ```yaml # compose.yml services: homehub: container_name: homehub image: ghcr.io/surajverma/homehub:latest ports: - "5000:5000" #app listens internally on port 5000 environment: - FLASK_ENV=production - SECRET_KEY=${SECRET_KEY:-} # set via .env; falls back to random if not provided volumes: - ./uploads:/app/uploads - ./media:/app/media - ./pdfs:/app/pdfs - ./data:/app/data - ./config.yml:/app/config.yml:ro
Self-hosting gives you three things SaaS can’t: data ownership (the files live on disks you control), cost predictability (a one-time setup vs. recurring per-seat fees that grow with your household or team), and longevity (open-source means the app keeps working even if the maintainers move on, since you can pin a working version). The trade-off is that you take on the operational work of running a server, applying updates, and handling backups.
Most self-hosted apps run comfortably on modest hardware — a Raspberry Pi 4, a mini PC, a NAS with Docker support, or a small VPS is usually enough for personal or family use. CPU and RAM requirements scale with how many simultaneous users or how much data you push through HomeHub. Storage requirements depend on the kind of data you keep; check the README for guidance on data retention.