# Miles' Home Server Stack

This repository contains a fully automated, containerized home server stack. It uses Docker for containerization, Caddy for reverse proxying, and is optimized for access via Tailscale.

## Quick Start (New System)

If you are setting this up on a fresh install, follow these three steps:

1. **Prepare the Script**: Run `chmod +x setup.sh`
2. **Run the Setup**: Execute `./setup.sh` (This will install Docker if missing, create all required folders in `/home/miles/`, and set correct permissions.)
3. **Launch**: Choose "Option 1" from the script menu to pull the images and start the services.

## Service Map & Navigation

All services are accessible via: `http://raspberrypi.tail46eacb.ts.net:4533` (or your local IP)

| Service      | Path    | Function                  |
|--------------|---------|---------------------------|
| Homarr      | /      | Central Dashboard (Landing Page) |
| Code-Server | /edit  | VS Code Web IDE           |
| Gitea       | /git   | Private Git Server        |
| Navidrome   | /music | Music Streaming           |
| RomM        | /roms  | Retro Game Manager        |
| Trilium     | /notes | Knowledge Base / Notes    |
| Excalidraw  | /draw  | Digital Whiteboard        |
| qBittorrent | /tr    | Download Manager          |
| ntfy        | /ntfy  | Push Notifications        |

## Directory Structure

The `setup.sh` script automatically manages these paths:

- **Configs**: `/home/miles/code-config`, `/home/miles/qbittorrent-config`
- **Data**: `/home/miles/gitea-data`, `/home/miles/trilium-data`, `/home/miles/homarr-data`
- **Media**: `/home/miles/navidrome-music`, `/home/miles/roms`, `/home/miles/downloads`

## Maintenance via setup.sh

Run `./setup.sh` at any time to access the management menu:

- **Update Apps**: Option 4 pulls the latest versions and restarts.
- **Check Status**: Option 5 shows which containers are running.
- **Logs**: Option 3 is vital for debugging startup issues.

## Troubleshooting Guide

### [A] Permissions Issues
If a container won't start or says "Access Denied":
- Fix: `sudo chown -R 1000:1000 /home/miles/`

### [B] Caddy Routing Problems
If you see a "404" or "Blank Page" on a sub-path:
- Ensure container names in `Caddyfile` match `docker-compose.yml`.
- Run: `docker exec -it caddy caddy validate --config /etc/caddy/Caddyfile`

### [C] Database Locks
If an app hangs (Gitea/Trilium), it may have a database lock.
- Fix: `docker compose restart [service-name]`

### [D] Networking Conflicts
If port 4533 is in use, Caddy will fail.
- Check: `sudo netstat -tulpn | grep 4533`

## Important Notes

- **Watchtower**: Runs in the background to auto-update apps.
- **Security**: Change the code-server password in `docker-compose.yml`.
- **Tailscale**: Must be "Connected" for the Gitea URL to work.
- **custom domans**: you can use custm domands but you need to use cloudefar tunnel with canday