# **🏠 Home-Server Stack**

[![OS](https://img.shields.io/badge/OS-Debian-C51A4A?logo=debian&logoColor=white&style=flat-square)](https://www.debian.org)
[![Docker](https://img.shields.io/badge/Podman-10_Services-2496ED?logo=podman&logoColor=white&style=flat-square)](./stack/)

**[Selfhosted Apps](#selfhosted-apps)** • **[Scripts](#scripts)**

A self-hosted home server setup running on Debian with Podman. \
I mainly use this for Taskmanagement, Backups and DNS Adblock.

---

<div align="center">
<img src="assets/HomeLab.drawio.png" width="600" height="600" alt="Preview">
</div>

---

## Selfhosted Apps
| Service | Description |
|--------|-------------|
| 🧠 Glance | Dashboard |
| ⛔️ AdGuard-Home | DNS Adblock |
| 🔒 Vaultwarden | Password Manager |
| ✅ Vikunja | Task Management |
| 📁 Filebrowser-Quantum | File Management |
| 💰 Wallos | Subscription Tracker |
| ⛓️ Caddy | Reverse-Proxy and Internal SSL |
| 📝 MicroBin| Text and File Sharing |
| 🩺 Healthchecks.io | Monitor Background Jobs |
| 🌐 Cloudflared | Cloudflare Tunnel |

## Scripts
| Script | Purpose |
|--------|---------|
| logging.sh | Universal logger |
| cleanup.sh | System cleanup |
| backup.sh | Backups (private) |
| check_podman.sh | Containers uptime check |
| check_disks.sh | Check disks health |
| pushover.sh | Send messages to myself via Pushover |

I also use [Server-VibeCheck](https://github.com/Knuspii/Server-VibeCheck)

---

## ⚙️ System Setup (Debian)
### Base packages I use
```bash
sudo apt install htop ssh rsync ncdu curl tree jq smartmontools fastfetch at mdadm
```

## 📊 Notes
- Secrets are stored in `.env` (not committed obviously)
- Rootless by default — containers run as a regular user, not as root.
- Better isolation — no central Docker daemon running with root privileges.
- Easy to automate — containers are started through simple shell scripts.

---

## 🧠 Author
Home server stack by Knuspii