Skip to content

A systems approach to private, self-hosted, smart homes. Powered by Runtipi, openHAB, Zigbee2MQTT, Caddy and Headscale.

Notifications You must be signed in to change notification settings

handcrafted-systems/runtipi-appstore

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Handcrafted Systems

Are you looking for a privacy-focused, self-hosted, smart home system?


πŸš€ Table of Contents


✨ Features

  • 🏠 Smart home partner | Guided approach to smart spaces
  • πŸ›‘οΈ Private, local-first | Personal, secure access always
  • πŸ™Œ Personalised & custom | Consultations available
  • πŸ”’ Pinned versions | No upstream supply chain risk
  • πŸš€ Verified updates | Latest versions always inspected
  • 🧩 Easy to extend & scale | Integrated structure
  • 🀝 Direct & community support | Email/chat & app communities

πŸ” Overview

πŸ’» Hardware Layer

Name Purpose Type Config GUI/CLI Port(s)
Raspberry Pi 5 (A) Mid-spec, accessible hub SBC Raspi OS Lite Both Eth/WiFi+USB
Mini PC (B) High-spec, costly hub Mini PC Proxmox Both Eth/WiFi+USB
Old PC (C) Mid/low-spec, but free PC Proxmox Both Eth/WiFi+USB
Zigbee Coordinator Sensor & trigger connectivity Dongle Pass-through N/A /dev/ttyACM0
Raspberry Pi Zero 2 W Core services fallback hub SBC dietpi CLI WiFi
HDD/NVMe/SSD Shared storage with redunancy DAS mount/fstab/samba Both USB/Eth

πŸ›œ Network Layer

Name Purpose Type Config GUI/CLI Port(s)
Zigbee2MQTT MQTT translation + Admin Container handcraftedsys GUI 8290
MQTT Pub/Sub Container handcraftedsys N/A 1883,9001
Pi-hole Local DNS + Ad-blocking Container handcraftedsys GUI 8081

πŸ”’ Security Layer

Name Purpose Type Config GUI/CLI Port(s)
acme.sh Local HTTPS Cron ~/.acme.sh /certs CLI N/A
Headscale Tailscale control server Container handcraftedsys CLI* 27896,9090
Tailscale Pi-hole Tailnet inclusion Service cmdline CLI N/A

* GUI to be added (Headplane / Headscale-UI)

🧩 Application Layer

🌐 Server

Name Purpose Type Config GUI/CLI Port(s)
Caddy Reverse-proxy Service /etc/caddy *.caddy GUI 80,443
Runtipi App store Container ~/runtipi Both 9079,9443
DuckDNS Dynamic DNS Container handcraftedsys N/A N/A

πŸ“ƒ Content

Name Purpose Type Config GUI/CLI Port(s)
Apprise Notifications Container handcraftedsys Both 8000
Uptime Kuma Service monitoring & alerts Container handcraftedsys GUI 8125
TriliumNext Notes, diagrams & more Container handcraftedsys GUI 8267

πŸͺ„ Automation

Name Purpose Type Config GUI/CLI Port(s)
openHAB Rules, scenes, history Service /etc/openhab Both* 8080
ESPHome ESP32-based sensors/triggers TBD TBD TBD TBD
Home Assistant Rules, scenes, history TBD TBD TBD TBD

*Karaf console only accessible via CLI

πŸ‘·β€β™‚οΈ Upcoming

Name Purpose Type Config GUI/CLI Port(s)
raspiBackup Scheduled back-ups Cron TBD CLI TBD
Authentik/Pocket-ID OIDC provider Container handcraftedsys GUI 8387
Keepalived High-availability Service TBD CLI TBD
HomeBox Organising & tracking Container handcraftedsys GUI TBD
Syncthing P2P file syncing Container handcraftedsys GUI TBD

⚠️ Prerequisites

Hardware

  • Raspberry Pi 5 | Coming soon!
  • Raspberry Pi Zero 2 W | Coming soon!

Runtipi

This repository includes a collection of third-party container applications ("apps") designed exclusively for use with Runtipi.io.

What is Runtipi?

Runtipi is an open-source platform that lets you easily self-host and manage web applications on your own server, with a beautiful web UI and one-click app installation.

Warning

These apps are only compatible with Runtipi. You must have a working Runtipi instance to use this App Store. They will not work as standalone Docker containers.


πŸ› οΈ Installation

Services

  • Caddy | Coming soon!
  • openHAB | Coming soon!
  • Tailscale | Coming soon!

Apps (Containers)

  1. In the Runtipi dashboard, open Settings and go to the App Stores tab.
  2. Click Add App Store, fill in the form with handcraftedsys and the URL https://github.com/handcrafted-systems/runtipi-appstore then click Submit
  3. You can now go to the App Store page and select the one you just created from the dropdown.

Cron

  • acme.sh | Coming soon!

❓ FAQ

Q: How do I get started?
A: Clear the prerequisites then follow the installation instructions.

Q: How is my data handled?
A: All data is fully controlled & secured by you through the steps noted above. Third-party access is restricted by default & remote support is only available if you choose to add it.

Q: How will this help me?
A: Whether you're looking for comfort at home, convenience on the go or the ability to have full control of your choices, data and privacy, this is a great way to avchieve it.

Q: How can I request a new tool/service/app?
A: Reach out to us directly via email/chat or open an issue titled appropriately ex. "[APP] App Name". All requests are vetted for alignment with our clear & friendly approach to smart spaces.

Q: How are apps updated?
A: Via Renovate, with secure CI/CD upcoming.

Q: Where can I find more about Runtipi?
A: See the official website & documentation and the Runtipi GitHub repository.


πŸ™ Acknowledgements

  • Special thanks to all upstream projects and container authors referenced in each app's description.
  • Thanks to all (active/passive) contributors and users!

πŸ—οΈ Built With

  • Ansible
  • Runtipi | openHAB
  • Docker, GitHub & LinuxServer Containers
  • GitHub Actions | Renovate
  • YAML | JSON | Markdown
  • Tmux | zsh | oh-my-posh
  • VS Code | Copilot | Gemini

πŸ’¬ Contact

  • πŸ’­ Create a new Discussion here on the repo
  • ❓ Create a new Issue here on the repo
  • πŸ“§ Reach out to us via email: hello at handcrafted dot systems

Made with β€οΈπŸ˜…β˜• in Bengaluru

About

A systems approach to private, self-hosted, smart homes. Powered by Runtipi, openHAB, Zigbee2MQTT, Caddy and Headscale.

Topics

Resources

Stars

Watchers

Forks

Sponsor this project

Contributors 2

  •  
  •