blumeops/docs/reference/infrastructure/ringtail.md
Erich Blume 8c99efee79 Polish ringtail NixOS config and add documentation
Sway keybinding for wezterm, fish as default shell, remove
initialPassword, add 1Password/chezmoi/dev tool packages.
Add ringtail reference card and update host inventory.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 09:51:10 -08:00

48 lines
1.5 KiB
Markdown

---
title: Ringtail
modified: 2026-02-18
tags:
- infrastructure
- host
---
# Ringtail
Service host and gaming PC. Custom-built PC running NixOS.
## Specifications
| Property | Value |
|----------|-------|
| **CPU** | AMD (desktop) |
| **GPU** | NVIDIA RTX 4080 (16GB VRAM) |
| **Storage** | NVMe (boot) + 3x SATA drives |
| **OS** | NixOS 25.11 (Sway/Wayland) |
| **Tailscale hostname** | `ringtail.tail8d86e.ts.net` |
## Software
Managed declaratively via `nixos/ringtail/configuration.nix`.
- **Desktop:** Sway (Wayland compositor) with wezterm terminal
- **Shell:** Fish (default login shell)
- **Gaming:** Steam
- **Dotfiles:** chezmoi (requires `.chezmoiignore` updates in dotfiles repo for Linux)
- **Secrets:** 1Password CLI + GUI (CLI integration via desktop app biometric unlock)
## Maintenance Notes
**NixOS rebuild:** From the blumeops repo, run `mise run provision-ringtail` or on ringtail directly:
```bash
sudo nixos-rebuild switch --flake /etc/nixos#ringtail
```
**NVIDIA drivers:** Uses proprietary (closed-source) drivers. The `--unsupported-gpu` flag is passed to sway via greetd since sway officially only supports open-source drivers.
**Chezmoi:** The dotfiles repo (`github.com/eblume/dotfiles`) is macOS-centric. A `.chezmoiignore` needs to be added to skip macOS-only files on Linux (Brewfile, macOS-specific PATH/SSH_AUTH_SOCK). This is tracked as a separate task outside blumeops.
## Related
- [[hosts]] - Device inventory
- [[tailscale]] - Network configuration