# 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

> These are stored here for admin reference. Do not share.

### Mealie
| Key | Value |
|---|---|
| Auth Token | `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb25nX3Rva2VuIjp0cnVlLCJpZCI6IjNkZjZkZmM0LTkyZDgtNDIyNy1iMjBjLTA4ZjA2Njc2MGcă0IsIm5hbWUiOiJMTE0gIiwiaW50ZWdyYXRpb25faWQiOiJnZW5lcmljIiwiZXhwIjoxOTE5OTEwNDUwfQ.Ts5XbrF6Nr-0gvhKkt_01OPeAEoWQe_ndn0hGTtPOQc` |

### Discord Bots
| Bot | Token |
|---|---|
| Isomer | `NjY0MjMyOTYxMjM4ODkyNTc0.XhUFJg.ivnkBPtnEPGGcAwaXP50rOIPZsI` |
| Star-15 | `ODQ2MTUxMDMxMjA1MDAzMjc0.GYFbRW.JeFITOZbBH_lqCuF-bS7edC0P30H6uqFKwz7is` |

### AI
| Service | Key |
|---|---|
| Gemini API | `AIzaSyD0uj33T_SH4Fvw2sWWW9akXF6ej9sqhlI` |

### Server Passwords
Shared password used across most Docker services (DB passwords, NextAuth secrets, etc.): see compose files at `/home/artanis/DockerFiles/` on the homelab.

---

## File Index

```
21-Server Reference/
├── README.md               ← You are here
├── Server Info.md          ← Legacy notes (superseded by this file)
├── 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
```