78 lines
2.5 KiB
Markdown
78 lines
2.5 KiB
Markdown
# Server Reference
|
|
|
|
Documentation for the home infrastructure — two servers working together.
|
|
|
|
## Servers
|
|
|
|
| Server | Role | Docs |
|
|
| ------------------------- | ---------------------------------------------------------- | ------------------ |
|
|
| **Homelab** | Primary server. Runs most services. | [[homelab/README]] |
|
|
| **Pihole / Raspberry Pi** | Secondary server. DNS, Home Assistant, Tailscale bridging. | [[pihole/README]] |
|
|
|
|
---
|
|
|
|
## Tailscale Sidecar Setup
|
|
|
|
The standard pattern for exposing a service via Tailscale. Used across nearly every stack.
|
|
|
|
1. Create your service container and a Tailscale sidecar container
|
|
2. On the sidecar, set:
|
|
```yaml
|
|
network_mode: "service:[service-name]"
|
|
```
|
|
3. Connect to the sidecar via SSH or the Tailscale admin console and run:
|
|
```
|
|
tailscale funnel --bg [port]
|
|
```
|
|
|
|
The sidecar shares the main container's network namespace, so Tailscale sees the service's ports as its own.
|
|
|
|
---
|
|
|
|
## Credentials & Tokens
|
|
|
|
All credentials are stored in an encrypted file: `credentials.gpg` (AES256, GPG symmetric).
|
|
|
|
To decrypt:
|
|
```bash
|
|
gpg -d "credentials.gpg"
|
|
```
|
|
|
|
Requires GPG — available on Linux/macOS natively, or [GPG4Win](https://gpg4win.org) on Windows. Works fully offline.
|
|
|
|
---
|
|
|
|
## File Index
|
|
|
|
```
|
|
21-Server Reference/
|
|
├── README.md ← You are here
|
|
├── AI-UPDATE-INSTRUCTIONS.md ← How to pull live data and update these docs
|
|
├── credentials.gpg ← Encrypted credentials (GPG AES256)
|
|
├── homelab/
|
|
│ ├── README.md — Homelab overview & stack index
|
|
│ ├── hardware.md — CPU, RAM, storage
|
|
│ ├── network.md — IPs, ports, Tailscale nodes, Docker networks
|
|
│ ├── environments.md — Dockhand environments (Homelab + Pihole)
|
|
│ └── stacks/
|
|
│ ├── README.md — All stacks at a glance
|
|
│ ├── dockhand.md
|
|
│ ├── minecraft.md
|
|
│ ├── mealie.md
|
|
│ ├── linkwarden.md
|
|
│ ├── gitea.md
|
|
│ ├── matrix.md
|
|
│ ├── homepage.md
|
|
│ ├── n8n.md
|
|
│ ├── calibre.md
|
|
│ ├── gluetun.md
|
|
│ ├── openproject.md
|
|
│ └── melodix.md
|
|
└── pihole/
|
|
├── README.md — Pi overview
|
|
└── stacks/
|
|
├── home_assistant.md
|
|
├── ts_kh_bridge.md
|
|
└── portainer_agent.md
|
|
```
|