# truenas-stacks

Docker Compose stacks for PlausibleDeniability (TrueNAS Scale), plus documentation for the full homelab.

## Servers

| Server | Role | OS | IP |
|--------|------|----|----|
| Serenity | NAS / Media ingestion | Unraid 7.2.4 | 10.5.1.5 |
| PlausibleDeniability | Primary Docker host | TrueNAS Scale 25.10.2.1 | LAN DHCP |
| N.O.M.A.D. | Offline knowledge + game servers | Ubuntu 25.10 | 10.5.1.16 |

## Repo Layout

```
databases/       # shared-postgres, shared-mariadb, shared-redis — deploy FIRST
infrastructure/  # newt, homepage, uptime-kuma, dockhand, netdata, tailscale — deploy SECOND
media/           # plex, tautulli, audiobookshelf, seerr, calibre-web-automated
photos/          # immich server + machine learning
home/            # kitchenowl, donetick, shlink, qui, dakboard bridges
dev/             # gitea, rackpeek
ai/              # ollama, openwebui
meshtastic/      # meshmonitor, mqtt-proxy, tileserver, meshtastic-map
automation/      # planned: gotify, n8n
search/          # planned: qdrant
docs/            # all homelab documentation
```

## Quick Start

1. Deploy `databases/` first
2. Deploy `infrastructure/` second (creates pangolin network via newt)
3. Deploy remaining stacks in any order

```bash
cd /mnt/docker-ssd/docker/compose/<stack>
docker compose --env-file .env config   # validate
docker compose --env-file .env up -d    # deploy
```

## Documentation

- [Architecture Overview](docs/architecture/ARCHITECTURE_OVERVIEW.md)
- [Networking Model](docs/architecture/NETWORKING_MODEL.md)
- [Hardware Inventory](docs/architecture/HARDWARE_INVENTORY.md)
- [Services Directory](docs/architecture/SERVICES_DIRECTORY.md)
- [Stack Standards](docs/operations/STACK_STANDARDS.md)
- [Deployment Checklist](docs/operations/DEPLOYMENT_CHECKLIST.md)
- [Storage Notes](docs/operations/DOCKERSTACK_STORAGE_NOTES.md)
- [Backup Policy](docs/operations/BACKUP_POLICY.md)
- [Secrets Management](docs/operations/SECRETS_MANAGEMENT.md)
- [Troubleshooting](docs/troubleshooting/TROUBLESHOOTING.md)
- [Known Quirks](docs/troubleshooting/KNOWN_QUIRKS.md)
- [Expansion Plan](docs/planning/HOMELAB_EXPANSION_PLAN.md)
- [TODO](docs/planning/TODO.md)
- [Serenity](docs/servers/SERENITY.md)
- [PlausibleDeniability](docs/servers/PLAUSIBLEDENABILITY.md)
- [N.O.M.A.D.](docs/servers/NOMAD.md)
- [Meshtastic Stack](docs/reference/MESHTASTIC.md)
- [AI Context](docs/reference/HOMELAB_AI_CONTEXT.md)