61 lines
2.4 KiB
Markdown
61 lines
2.4 KiB
Markdown
# 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 | 10.5.1.6 |
|
|
| 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)
|