clean up & hyprland experiments
- Cleaned up docs - removed hyprglass - added various ways to do scroll view
This commit is contained in:
1 parent
c304803fda
commit
3c86efa4ff
23 files changed
+443
-212
No files matched your search
@@ -16,14 +16,14 @@ server/
|
||||
├── dns/ # Local DNS resolver, certbot, local CA
|
||||
├── k3s/ # Single-binary K3s cluster role
|
||||
├── k8s/ # Full upstream Kubernetes (master/node)
|
||||
└── services/ # Self-hosted apps (jellyfin, audiobookshelf, comfyui, scrypted, dockge, ai…)
|
||||
└── services/ # Self-hosted apps (jellyfin, audiobookshelf, comfyui, ds4, colibri, ai…)
|
||||
```
|
||||
|
||||
## Notable details
|
||||
|
||||
- **`timers.nix`** is a reusable helper: anything added to `skyg.server.timers.<name>`
|
||||
(with `script`, `OnCalendar`, `wantedBy`) becomes a systemd timer + oneshot service. Other
|
||||
modules (e.g. `services/scrypted.nix`) use it for backups/auto-updates.
|
||||
(with `script`, `OnCalendar`, `wantedBy`) becomes a systemd timer + oneshot service. Host
|
||||
files (e.g. `hosts/hl-minipc2.nix`'s scrypted-backups) use it for backups/auto-updates.
|
||||
- **`exporters.nix`** enables the Prometheus node exporter with the systemd collector and
|
||||
opens port 9100.
|
||||
- Naming: this tree mostly uses the legacy `skyg.server.*` prefix for cross-cutting modules
|
||||
|
||||
@@ -45,16 +45,12 @@ Then add it to `services/default.nix`'s `imports` list (and to the `services/ABO
|
||||
6. **Scheduled jobs** (backups, auto-updates) should use the `skyg.server.timers.<name>`
|
||||
helper in `timers.nix` rather than hand-writing `systemd.timers`/`systemd.services`.
|
||||
7. **Secrets** (tokens, API keys, join tokens) come from **agenix** (`config.age.secrets.*`)
|
||||
or an `environmentFile` path — never hardcoded, never committed. See `openclaw.nix` for
|
||||
the agenix-token pattern and `k3s/`/`dns/routing/` for `envPath`/secret-file patterns.
|
||||
or an `environmentFile` path — never hardcoded, never committed. See `colibri.nix`/
|
||||
`signal-cli.nix` for the `environmentFile` (agenix) pattern and `k3s/`/`dns/routing/`
|
||||
for `envPath`/secret-file patterns.
|
||||
8. **Stable identities.** Where a service stores data on NFS, keep its `uid`/`gid` fixed and
|
||||
unique (see `arrs/` and `jellyfin.nix`) so ownership survives across hosts.
|
||||
|
||||
## Gotcha: openclaw.nix
|
||||
|
||||
`openclaw.nix` is **not** imported by `services/default.nix`. If you enable it, import it
|
||||
explicitly. Don't assume every file in `services/` is wired in.
|
||||
|
||||
## Validation
|
||||
|
||||
Do **not** build or switch (see root `GUIDELINES.md`). Use `nix-instantiate --parse` on the
|
||||
|
||||
@@ -12,9 +12,9 @@ services/
|
||||
├── default.nix # imports the services below
|
||||
├── ai-services.nix # skyg.nixos.server.services.ai — ollama + Wyoming (whisper/piper/wake)
|
||||
├── audiobookshelf.nix # skyg.nixos.server.services.audiobookshelf — audiobook/podcast server
|
||||
├── ds4.nix # skyg.nixos.server.services.ds4 — ds4-server HTTP API (DwarfStar local inference)
|
||||
├── jellyfin.nix # skyg.nixos.server.services.jellyfin — media server (uid/gid 7777)
|
||||
├── signal-cli.nix # skyg.nixos.server.services.signal-cli — signal-cli HTTP daemon (Hermes Signal bridge)
|
||||
├── openclaw.nix # skyg.nixos.server.services.openclaw — AI gateway (NOT imported by default)
|
||||
├── colibri.nix # skyg.nixos.server.services.colibri — coli serve HTTP API (GLM-5.2/OLMoE local inference)
|
||||
└── comfyui/ # skyg.nixos.server.services.comfyui — ComfyUI with ROCm/CUDA GPU support
|
||||
```
|
||||
@@ -23,9 +23,10 @@ services/
|
||||
|
||||
- **`ai-services.nix`** runs ollama (GPU-passthrough) and openwakeword as containers and
|
||||
enables NixOS-native Wyoming faster-whisper + piper. Opens 11434/10200/10300/10400.
|
||||
- **`openclaw.nix`** is a native systemd service (with agenix-token support and security
|
||||
hardening). Note: it is **not** listed in `default.nix`'s imports, so it must be imported
|
||||
explicitly if used.
|
||||
- **`ds4.nix`** runs `ds4-server` (the OpenAI/Anthropic-compatible HTTP API for DwarfStar
|
||||
DeepSeek V4 inference) as a native systemd service. `package` selects the backend
|
||||
(`pkgs.ds4` cpu / `pkgs.ds4-rocm` / `pkgs.ds4-cuda`); model path, ctx, KV offload, and
|
||||
GPU device IDs are all options.
|
||||
- **`colibri.nix`** runs `coli serve` (colibrì's OpenAI-compatible API) as a native systemd
|
||||
service, mirroring `services/ds4.nix`'s shape. `package` picks the backend (`pkgs.colibri`
|
||||
cpu / `pkgs.colibri-rocm`); `environmentFile` supplies `COLI_API_KEY` via agenix instead of
|
||||
@@ -36,10 +37,9 @@ services/
|
||||
```
|
||||
skyg.nixos.server.services.ai.enable
|
||||
skyg.nixos.server.services.audiobookshelf.{enable,package,configDir,dataDir}
|
||||
skyg.nixos.server.services.ds4.{enable,package,model,host,port,ctx,kvDiskDir,...}
|
||||
skyg.nixos.server.services.jellyfin.enable
|
||||
skyg.nixos.server.services.scrypted.enable
|
||||
skyg.nixos.server.services.signal-cli.{enable,host,port,configDir,account,environmentFile,openFirewall}
|
||||
skyg.nixos.server.services.openclaw.{enable,port,gatewayToken,...}
|
||||
skyg.nixos.server.services.colibri.{enable,package,model,host,port,environmentFile,openFirewall,...}
|
||||
skyg.nixos.server.services.comfyui.{enable,mode,port,openFirewall}
|
||||
```
|
||||
|
||||
Reference in new issue
Block a user