Compare commits
254 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| b6f4bb7955 | |||
| 74d65a0d75 | |||
| 85bd12778a | |||
| d9565448b9 | |||
| af2655f9e2 | |||
| 6d0684610e | |||
| 17c3a3189f | |||
| 18d1ce711d | |||
| cbdb42f333 | |||
| b44775e3e5 | |||
| 9ed0fb6f07 | |||
| ff6e25b708 | |||
| 2e5568611a | |||
| b44220adf1 | |||
| 45c6d978f2 | |||
| 62875c0b1a | |||
| d2775e35d9 | |||
| 4cb4455d37 | |||
| 933c2f8b41 | |||
| 1444912326 | |||
| d1299ed112 | |||
| 96fbeb04ef | |||
| 68f2c65246 | |||
| 787427e7c8 | |||
| 6251c8edef | |||
| 311e358d88 | |||
| 9ff3603d40 | |||
| 6d12940205 | |||
| dbeda276e1 | |||
| e8d09f40f6 | |||
| 098e632405 | |||
| ede28c8bb4 | |||
| db1f44c4ea | |||
| df05fe451e | |||
| 74abfe35a2 | |||
| c51a658b18 | |||
| 1b64ea5930 | |||
| eb21cb998f | |||
| 9342809975 | |||
| 2d43ed36ea | |||
| 004f04eca5 | |||
| 4296dda7f8 | |||
| b316b16a7f | |||
| ca1fa3810b | |||
| 337ba6c847 | |||
| 191e860455 | |||
| 93a36dbf2b | |||
| dc65b044cf | |||
| 3ce8459904 | |||
| 78f540a776 | |||
| 9757b987bb | |||
| f833439e0f | |||
| e1ea5b03dc | |||
| 9de69b7dcc | |||
| 9974bd49ac | |||
| b300f39c03 | |||
| 64eedeaac9 | |||
| 97633af170 | |||
| a4ad1e0754 | |||
| 9ec2df1afa | |||
| bc87844e76 | |||
| 39263f65f9 | |||
| a1e0dc499e | |||
| 24a211330a | |||
| 6f84bdefb4 | |||
| 49371f2e2b | |||
| b802659462 | |||
| 256fdc850b | |||
| ce4e8225f9 | |||
| dc2abe6ff1 | |||
| c3f4470f80 | |||
| c407e1e9ee | |||
| 6e73e9362d | |||
| 1fefc23c1b | |||
| 2b13f15711 | |||
| 514ee3c137 | |||
| 325ce5969c | |||
| 2945601aa3 | |||
| b15fe38d2f | |||
| 495f1a0645 | |||
| bb238e3369 | |||
| fa72edfc05 | |||
| d8341c3e38 | |||
| 204c358cea | |||
| 7c6dc43a41 | |||
| 76955ad6b3 | |||
| 74f1471bb9 | |||
| 8ce14dc6e0 | |||
| 619c6c6ed4 | |||
| 6086ace431 | |||
| c300b55e8f | |||
| 232fa2ead9 | |||
| 97981637a3 | |||
| 42d2702bad | |||
| af2d9af641 | |||
| c2a645a5b5 | |||
| 71f160c3e5 | |||
| 284ec2e841 | |||
| a2e1831cc7 | |||
| a3f2922017 | |||
| 0c393d81c8 | |||
| 6018134b12 | |||
| 192c1f5e56 | |||
| c9e725ff85 | |||
| eac2c87e2d | |||
| b3b3bf9f4b | |||
| f9906a9e96 | |||
| 3ec4a7135e | |||
| cfedf8aa17 | |||
| 6ee162822e | |||
| 0899f5ae70 | |||
| fecaa7dea9 | |||
| 9696357a24 | |||
| f252a997da | |||
| 1565cee96b | |||
| 45535629a8 | |||
| 6ea77c298c | |||
| 5ce59a0983 | |||
| 5d003e0b27 | |||
| 925ba42182 | |||
| de0e3f81bc | |||
| 5a869457af | |||
| d5a6e3a235 | |||
| 0aded836ac | |||
| 66c8eca980 | |||
| a529352343 | |||
| c65044ac75 | |||
| 02b44230f5 | |||
| 3df1fb2c0e | |||
| fa60eabd35 | |||
| 82e177d41b | |||
| 0b6c123099 | |||
| 082c07bbdd | |||
| a304d2fd9a | |||
| 9eb41081c3 | |||
| 6de80ac4a4 | |||
| c7071b4bf0 | |||
| fd2b310d92 | |||
| 6030e88a35 | |||
| 02f2deb219 | |||
| e22eb62d2b | |||
| 2985cd7ab2 | |||
| 5aae4ebf13 | |||
| 3174128bab | |||
| 5b2d8ce8b6 | |||
| 9fb7e97366 | |||
| b73f1f49a2 | |||
| 7019c9476c | |||
| 29b51380f1 | |||
| d7d23b1dd7 | |||
| 2c1b19052e | |||
| 5ab19e678c | |||
| 246927fc11 | |||
| 1da5a581f1 | |||
| c6763f4976 | |||
| c1ee956e02 | |||
| 5af5a1e300 | |||
| ef7fe9abc2 | |||
| 70076accf1 | |||
| 6ba6b3dca6 | |||
| dac0e346e7 | |||
| 5e40f81c99 | |||
| c1d83736eb | |||
| e8c653bf75 | |||
| 05da1808de | |||
| 7f601985bf | |||
| fa7587edf0 | |||
| 718a1d97d1 | |||
| e86a16c932 | |||
| 34bac6a33e | |||
| 5a4745e8db | |||
| e56039f7bb | |||
| f200837f0e | |||
| 4366b8612c | |||
| 73e4b2e7fb | |||
| f716e7c197 | |||
| 3533957964 | |||
| 28da6ce7ee | |||
| 76b89fb0d2 | |||
| 97ff99cd6d | |||
| 3279870a36 | |||
| 13d66ca328 | |||
| 483f7f50b7 | |||
| 718f722e54 | |||
| 182ad4c11e | |||
| b8ac8301d4 | |||
| 6d47fb5a66 | |||
| a4e51a59c0 | |||
| a602737262 | |||
| b1784be493 | |||
| 56eed9210c | |||
| de1b89071f | |||
| d04f30bf83 | |||
| c883dfb0e8 | |||
| 3163f69b28 | |||
| f2eded1341 | |||
| 13f418fef5 | |||
| 59270b9a76 | |||
| 9db8fc644a | |||
| 537da46c40 | |||
| dd14951d5a | |||
| 7b4d03d15a | |||
| 069711977d | |||
| a146ff81c8 | |||
| aecb93b24f | |||
| c02360f9dc | |||
| c7f68162da | |||
| 3f43d418e7 | |||
| bd0d018748 | |||
| beddbee7c3 | |||
| c90ae14937 | |||
| 80422ab0f4 | |||
| c9acad680a | |||
| 1c939f4049 | |||
| 9dd64d8a30 | |||
| 2572d4317f | |||
| c20bc9b377 | |||
| 72d1362676 | |||
| 4cdbc642ac | |||
| fe4b2bdee9 | |||
| 86e4ea6903 | |||
| ba81de27da | |||
| 83d9d979f6 | |||
| b546dad014 | |||
| 02fd6092e4 | |||
| 5e55e00c64 | |||
| d5724379ee | |||
| 11575dc441 | |||
| e4d62003f2 | |||
| d1138eee25 | |||
| 4f10febcdf | |||
| 578cd0b23f | |||
| b6b022dd02 | |||
| f8cee7df14 | |||
| 9d0f057e8c | |||
| bc5863280d | |||
| c24026dad0 | |||
| 7c1aa9a808 | |||
| 2845e94cee | |||
| 1e77d89666 | |||
| 09ff767c08 | |||
| 4fd9c70283 | |||
| d76325230c | |||
| 4eb538648e | |||
| 97c1d0e1d3 | |||
| 466720f02e | |||
| 55127d29d5 | |||
| 7bea34b915 | |||
| fe58b4a77a | |||
| 5121b50d36 | |||
| 498328fea7 | |||
| 2003e17fa4 | |||
| 92ed683b43 | |||
| 6173c533f2 |
@@ -0,0 +1,7 @@
|
||||
export DIRENV_WARN_TIMEOUT=5m
|
||||
|
||||
if ! has nix_direnv_version || ! nix_direnv_version 2.2.0; then
|
||||
source_url "https://raw.githubusercontent.com/nix-community/nix-direnv/2.2.0/direnvrc" "sha256-5EwyKnkJNQeXrRkYbwwRBcXbibosCJqyIUuz9Xq+LRc="
|
||||
fi
|
||||
|
||||
use flake
|
||||
@@ -0,0 +1 @@
|
||||
AGENTS.md
|
||||
@@ -0,0 +1,13 @@
|
||||
stages:
|
||||
- build
|
||||
|
||||
|
||||
jupiter-build:
|
||||
image: nixos/nix
|
||||
stage: build
|
||||
script:
|
||||
- ls -la
|
||||
- nix-build --version
|
||||
- nix flake show --extra-experimental-features 'nix-command flakes'
|
||||
- nix build '.#nixosConfigurations.jupiter.config.system.build.toplevel' --extra-experimental-features 'nix-command flakes'
|
||||
|
||||
Generated
+8
@@ -0,0 +1,8 @@
|
||||
# Default ignored files
|
||||
/shelf/
|
||||
/workspace.xml
|
||||
# Editor-based HTTP Client requests
|
||||
/httpRequests/
|
||||
# Datasource local storage ignored files
|
||||
/dataSources/
|
||||
/dataSources.local.xml
|
||||
Generated
+5
@@ -0,0 +1,5 @@
|
||||
<project version="4">
|
||||
<component name="ProjectRootManager">
|
||||
<output url="file://$PROJECT_DIR$/out" />
|
||||
</component>
|
||||
</project>
|
||||
Generated
+8
@@ -0,0 +1,8 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<project version="4">
|
||||
<component name="ProjectModuleManager">
|
||||
<modules>
|
||||
<module fileurl="file://$PROJECT_DIR$/.idea/nixos.iml" filepath="$PROJECT_DIR$/.idea/nixos.iml" />
|
||||
</modules>
|
||||
</component>
|
||||
</project>
|
||||
Generated
+9
@@ -0,0 +1,9 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<module type="JAVA_MODULE" version="4">
|
||||
<component name="NewModuleRootManager" inherit-compiler-output="true">
|
||||
<exclude-output />
|
||||
<content url="file://$MODULE_DIR$" />
|
||||
<orderEntry type="inheritedJdk" />
|
||||
<orderEntry type="sourceFolder" forTests="false" />
|
||||
</component>
|
||||
</module>
|
||||
Generated
+6
@@ -0,0 +1,6 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<project version="4">
|
||||
<component name="VcsDirectoryMappings">
|
||||
<mapping directory="" vcs="Git" />
|
||||
</component>
|
||||
</project>
|
||||
@@ -0,0 +1,92 @@
|
||||
# CLAUDE.md
|
||||
|
||||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||||
|
||||
## Commands
|
||||
|
||||
```bash
|
||||
# Apply configuration (switch/boot/test)
|
||||
sudo nixos-rebuild switch --flake '.#jupiter'
|
||||
sudo nixos-rebuild switch --flake '.#mibook'
|
||||
|
||||
# Build without switching (CI-style check)
|
||||
nix build '.#nixosConfigurations.jupiter.config.system.build.toplevel'
|
||||
|
||||
# Update all flake inputs
|
||||
nix flake update
|
||||
|
||||
# Format Nix files
|
||||
nixfmt-rfc-style <file> # or: find . -name '*.nix' | xargs nixfmt-rfc-style
|
||||
```
|
||||
|
||||
## Architecture
|
||||
|
||||
This is a flake-parts NixOS configuration for two machines:
|
||||
|
||||
- **jupiter** — home server running media/automation services
|
||||
- **mibook** — laptop running KDE desktop + development tools
|
||||
|
||||
### Module Loading Chain
|
||||
|
||||
```
|
||||
flake.nix
|
||||
└── machines/configuration.nix # flake-parts module; defines nixosConfigurations
|
||||
├── machines/core/ # base modules applied to every machine
|
||||
│ ├── core.nix # system packages, locale, timezone
|
||||
│ ├── network.nix
|
||||
│ ├── nix.nix
|
||||
│ └── users.nix
|
||||
├── modules/ # custom NixOS option modules (my.profiles.*, my.hardware.*, my.services.*)
|
||||
│ ├── environments/ # per-service/app profiles
|
||||
│ ├── hardware/ # hardware profiles (nvidia, bluetooth, sound, wifi)
|
||||
│ └── services/ # infrastructure services (vpn, webserver)
|
||||
└── machines/<name>/
|
||||
├── configuration.nix # machine-specific NixOS settings
|
||||
├── environments.nix # enables profiles via my.profiles.* / my.hardware.* options
|
||||
├── disks.nix
|
||||
└── hardware-configuration.nix
|
||||
```
|
||||
|
||||
### Profile / Module Pattern
|
||||
|
||||
Every module under `modules/` follows the same structure:
|
||||
|
||||
```nix
|
||||
{ config, lib, pkgs, ... }:
|
||||
let cfg = config.my.profiles.<name>; in
|
||||
{
|
||||
options.my.profiles.<name>.enable = lib.mkEnableOption "...";
|
||||
config = lib.mkIf cfg.enable { ... };
|
||||
}
|
||||
```
|
||||
|
||||
Namespaces in use:
|
||||
- `my.profiles.*` — application/service profiles
|
||||
- `my.hardware.*` — hardware profiles
|
||||
- `my.services.*` — infrastructure services
|
||||
|
||||
Profiles are enabled per-machine in `machines/<name>/environments.nix`.
|
||||
|
||||
### Unstable Packages
|
||||
|
||||
`pkgs.unstable` is available everywhere via an overlay defined in `machines/configuration.nix`. Use it when a package isn't in the pinned stable channel (`nixpkgs/nixos-25.11`).
|
||||
|
||||
### Homepage Dashboard Integration
|
||||
|
||||
Modules that expose a web UI can self-register with the homepage dashboard by adding to `my.homepage.services`:
|
||||
|
||||
```nix
|
||||
my.homepage.services = [{
|
||||
group = "Services";
|
||||
name = "My Service";
|
||||
description = "...";
|
||||
href = "http://${hostName}:PORT";
|
||||
icon = "si-iconname"; # optional
|
||||
}];
|
||||
```
|
||||
|
||||
### Adding a New Service Module
|
||||
|
||||
1. Create `modules/environments/<name>/default.nix` following the profile pattern above.
|
||||
2. Add `./environments/<name>` to `modules/environments/default.nix` (or the relevant `default.nix`).
|
||||
3. Enable it in the target machine's `machines/<name>/environments.nix`.
|
||||
@@ -1,3 +1,31 @@
|
||||
# nixos
|
||||
# Private NixOS Configuration
|
||||
|
||||
Private NixOS configuration
|
||||
[Felix Nixos Config](https://github.com/Stunkymonkey/nixos)
|
||||
|
||||
## Structure
|
||||
|
||||
```
|
||||
.
|
||||
├── images # custom image generations
|
||||
├── machines # machine definitions
|
||||
├── modules # own nix-options, to modularize services/hardware/...
|
||||
├── overlays # overlays
|
||||
├── pkgs # own packages, which are not available in nixpkgs
|
||||
└── environments # summarize module collections into single options
|
||||
```
|
||||
|
||||
## Commands
|
||||
|
||||
```bash
|
||||
# Rebuild (switch/boot/test)
|
||||
sudo nixos-rebuild switch --flake '.#jupiter'
|
||||
|
||||
|
||||
# Update Flake
|
||||
nix flake update
|
||||
|
||||
# Channel list
|
||||
sudo nix-channel --list
|
||||
# Channel update
|
||||
sudo nix-channel --update
|
||||
```
|
||||
|
||||
@@ -0,0 +1,607 @@
|
||||
# ZBT-2 Thread + OTBR Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
**Goal:** Run the Home Assistant Connect ZBT-2 as an OpenThread Border Router on `jupiter`, fully integrated with the existing native `services.home-assistant` + `services.matter-server` stack so Matter-over-Thread devices commission through the dongle.
|
||||
|
||||
**Architecture:** Single NixOS module file (`modules/environments/home-assistant/default.nix`) is edited to import the `services.openthread-border-router` module from `nixos-unstable` (not yet in 25.11 stable), enable it against the ZBT-2's `/dev/serial/by-id/...` path, and add HA's `otbr` + `thread` extra components. The previous ZHA-direction commit on this branch is reverted first. The dongle is one-time-flashed from Zigbee NCP firmware to OpenThread RCP firmware via `universal-silabs-flasher` outside the NixOS lifecycle (per design decision: option B, CLI-only).
|
||||
|
||||
**Tech Stack:** Nix flakes (flake-parts), NixOS 25.11 stable + nixos-unstable, `services.openthread-border-router`, `services.home-assistant`, `services.matter-server`, `python313Packages.universal-silabs-flasher`.
|
||||
|
||||
**Spec:** [`docs/superpowers/specs/2026-05-10-zbt2-thread-otbr-design.md`](../specs/2026-05-10-zbt2-thread-otbr-design.md) — read this before starting.
|
||||
|
||||
**User feedback rules in force:**
|
||||
- Never commit to `master`; this branch is `feature/ha-zbt-2-thread`. Final merge happens at the end via PR or operator-driven merge.
|
||||
- Do not SSH to `jupiter`. All commands targeting jupiter are operator handoffs — present the command, the user runs it and pastes output back.
|
||||
|
||||
---
|
||||
|
||||
## File Map
|
||||
|
||||
| Action | File | Responsibility |
|
||||
|--------|------|----------------|
|
||||
| Modify | `modules/environments/home-assistant/default.nix` | Import unstable OTBR module; enable OTBR for the ZBT-2; add `otbr` + `thread` HA components |
|
||||
| Modify | `machines/configuration.nix` | Pass `self` via `specialArgs` so it's available during NixOS module **imports** evaluation (not just config) |
|
||||
| Create (auto) | _(no new files)_ | All work fits in the two modules |
|
||||
|
||||
The `git revert` of `e8d09f4` automatically un-modifies the home-assistant module (drops `"zha"` and the `dialout` line). No host-level (`machines/jupiter/`) changes.
|
||||
|
||||
**Why the flake-level edit is needed:** the existing `_module.args.self = self;` in `machines/configuration.nix:21` makes `self` available in module bodies (option definitions, `config` blocks). It does **not** make `self` available during `imports` evaluation — `_module.args` is resolved from `config`, but `imports` are collected **before** `config` is evaluated, so `self` in `imports` causes an infinite recursion error. Promoting `self` to `specialArgs` short-circuits that and is the conventional fix.
|
||||
|
||||
---
|
||||
|
||||
## Validation Approach (instead of unit tests)
|
||||
|
||||
This is a NixOS configuration change; there's no test framework. We use `nix eval` against `nixosConfigurations.jupiter.config.*` as the equivalent of unit tests — assert option resolution **before** the change (red), then **after** the change (green). Functional / smoke tests happen post-`nixos-rebuild` on jupiter via systemctl, mDNS, and the HA UI.
|
||||
|
||||
All `nix eval` commands run on the dev Mac. All `systemctl` / `journalctl` / `nixos-rebuild` commands run on jupiter (operator handoff).
|
||||
|
||||
---
|
||||
|
||||
### Task 1: Revert the prior ZHA commit
|
||||
|
||||
**Files:**
|
||||
- Modify: `modules/environments/home-assistant/default.nix` (via `git revert`)
|
||||
|
||||
- [ ] **Step 1: Verify pre-state**
|
||||
|
||||
On dev Mac, in the repo root:
|
||||
|
||||
```bash
|
||||
git log --oneline -3
|
||||
```
|
||||
|
||||
Expected: `dbeda27` (design spec) on top of `e8d09f4` (the ZHA commit) on top of `098e632`.
|
||||
|
||||
Also confirm current `extraComponents` includes `"zha"`:
|
||||
|
||||
```bash
|
||||
nix eval --json .#nixosConfigurations.jupiter.config.services.home-assistant.extraComponents
|
||||
```
|
||||
|
||||
Expected: `["matter","mobile_app","zha"]`
|
||||
|
||||
- [ ] **Step 2: Revert**
|
||||
|
||||
```bash
|
||||
git revert --no-edit e8d09f4
|
||||
```
|
||||
|
||||
Expected: revert commit created cleanly (no merge conflicts), single file changed.
|
||||
|
||||
- [ ] **Step 3: Verify post-state**
|
||||
|
||||
```bash
|
||||
nix eval --json .#nixosConfigurations.jupiter.config.services.home-assistant.extraComponents
|
||||
```
|
||||
|
||||
Expected: `["matter","mobile_app"]` — `zha` is gone.
|
||||
|
||||
```bash
|
||||
nix eval --json .#nixosConfigurations.jupiter.config.users.users.hass.extraGroups
|
||||
```
|
||||
|
||||
Expected: `[]` — `dialout` is gone.
|
||||
|
||||
```bash
|
||||
git log --oneline -4
|
||||
```
|
||||
|
||||
Expected: revert commit on top of `dbeda27` on top of `e8d09f4`.
|
||||
|
||||
(No explicit `git commit` step — `git revert` produced its own commit.)
|
||||
|
||||
---
|
||||
|
||||
### Task 2: Wire the unstable OTBR module import (still disabled)
|
||||
|
||||
This task gets the module into scope so options become available, but leaves `services.openthread-border-router.enable = false` (the default). The point is to confirm the import path works before adding device-specific config.
|
||||
|
||||
**Files:**
|
||||
- Modify: `machines/configuration.nix` (add `specialArgs = { inherit self; };` to each `nixosSystem` call)
|
||||
- Modify: `modules/environments/home-assistant/default.nix`
|
||||
|
||||
- [ ] **Step 1: Write the failing eval check**
|
||||
|
||||
On dev Mac:
|
||||
|
||||
```bash
|
||||
nix eval --json .#nixosConfigurations.jupiter.options.services.openthread-border-router.enable.description 2>&1 | head -3
|
||||
```
|
||||
|
||||
Expected: error containing `attribute 'openthread-border-router' missing` or similar — the option doesn't exist yet because the module isn't imported.
|
||||
|
||||
- [ ] **Step 1a: Promote `self` to `specialArgs` in `machines/configuration.nix`**
|
||||
|
||||
`self` must be reachable during `imports` evaluation (not just `config` evaluation). The existing `_module.args.self = self;` only covers `config`-time access. Edit each `nixosSystem` call (`jupiter` and `mibook`) to add `specialArgs`.
|
||||
|
||||
Current shape (lines 50–56 and 57–63):
|
||||
|
||||
```nix
|
||||
jupiter = nixosSystem {
|
||||
system = "x86_64-linux";
|
||||
modules = defaultModules ++ [
|
||||
# nixos-hardware.nixosModules.bmax-b7-power
|
||||
./jupiter/configuration.nix
|
||||
];
|
||||
};
|
||||
mibook = nixosSystem {
|
||||
system = "x86_64-linux";
|
||||
modules = defaultModules ++ [
|
||||
# nixos-hardware.nixosModules.mibook
|
||||
./mibook/configuration.nix
|
||||
];
|
||||
};
|
||||
```
|
||||
|
||||
Add `specialArgs = { inherit self; };` to each:
|
||||
|
||||
```nix
|
||||
jupiter = nixosSystem {
|
||||
system = "x86_64-linux";
|
||||
specialArgs = { inherit self; };
|
||||
modules = defaultModules ++ [
|
||||
# nixos-hardware.nixosModules.bmax-b7-power
|
||||
./jupiter/configuration.nix
|
||||
];
|
||||
};
|
||||
mibook = nixosSystem {
|
||||
system = "x86_64-linux";
|
||||
specialArgs = { inherit self; };
|
||||
modules = defaultModules ++ [
|
||||
# nixos-hardware.nixosModules.mibook
|
||||
./mibook/configuration.nix
|
||||
];
|
||||
};
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Add `self` to the module's argument list and add the `imports` block**
|
||||
|
||||
Current header (`modules/environments/home-assistant/default.nix` lines 1–11):
|
||||
|
||||
```nix
|
||||
# manages home automations
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.home-assistant;
|
||||
hostName = config.networking.hostName;
|
||||
in
|
||||
```
|
||||
|
||||
Replace lines 1–11 with:
|
||||
|
||||
```nix
|
||||
# manages home automations
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
self,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.home-assistant;
|
||||
hostName = config.networking.hostName;
|
||||
in
|
||||
```
|
||||
|
||||
Then, immediately after the opening brace on line 12 of the modified file (i.e. at the top of the attribute set body, before `options.my.profiles.home-assistant`), add:
|
||||
|
||||
```nix
|
||||
imports = [
|
||||
# services.openthread-border-router isn't in nixos-25.11; pull from
|
||||
# nixpkgs-unstable. Package comes from the existing unstable overlay.
|
||||
"${self.inputs.nixpkgs-unstable}/nixos/modules/services/home-automation/openthread-border-router.nix"
|
||||
];
|
||||
|
||||
```
|
||||
|
||||
- [ ] **Step 3: Re-run the eval check**
|
||||
|
||||
```bash
|
||||
nix eval --json .#nixosConfigurations.jupiter.options.services.openthread-border-router.enable.description 2>&1 | head -3
|
||||
```
|
||||
|
||||
Expected: a JSON string describing the option (e.g. `"Whether to enable the OpenThread Border Router."`).
|
||||
|
||||
- [ ] **Step 4: Verify the service is currently disabled**
|
||||
|
||||
```bash
|
||||
nix eval --json .#nixosConfigurations.jupiter.config.services.openthread-border-router.enable
|
||||
```
|
||||
|
||||
Expected: `false`.
|
||||
|
||||
- [ ] **Step 5: Verify whole config still evaluates**
|
||||
|
||||
```bash
|
||||
nix eval .#nixosConfigurations.jupiter.config.system.build.toplevel.drvPath
|
||||
```
|
||||
|
||||
Expected: a `/nix/store/...drv` path. Pre-existing trace warnings (the `*.service ordered after network-online.target` ones) are fine; no errors.
|
||||
|
||||
- [ ] **Step 6: Commit**
|
||||
|
||||
```bash
|
||||
git add machines/configuration.nix modules/environments/home-assistant/default.nix
|
||||
git commit -m "$(cat <<'EOF'
|
||||
feat(home-assistant): import openthread-border-router module from unstable
|
||||
|
||||
Pulls the services.openthread-border-router NixOS module directly from
|
||||
nixpkgs-unstable since it isn't in 25.11 yet. Service stays disabled
|
||||
in this commit; configuration follows.
|
||||
|
||||
Also promotes `self` from `_module.args` to `specialArgs` in
|
||||
machines/configuration.nix, since `imports` are evaluated before
|
||||
`config` and so can't reach `_module.args.self`.
|
||||
|
||||
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
||||
EOF
|
||||
)"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Task 3: Operator handoff — get the ZBT-2 device path from jupiter
|
||||
|
||||
This task has no code. It collects the runtime parameter (USB serial number) that Task 4 needs.
|
||||
|
||||
**Files:** _(none)_
|
||||
|
||||
- [ ] **Step 1: Hand off**
|
||||
|
||||
Tell the operator:
|
||||
|
||||
> "Plug the ZBT-2 into a USB-2 port on jupiter (it's still on stock Zigbee firmware — that's fine for this step). Then run `ls -l /dev/serial/by-id/` on jupiter and paste the full output back. We're after the line that contains `Nabu_Casa_Home_Assistant_Connect_ZBT-2`."
|
||||
|
||||
- [ ] **Step 2: Wait for the operator's pasted output**
|
||||
|
||||
Expected shape: a line like
|
||||
`lrwxrwxrwx 1 root root 13 May 10 14:30 usb-Nabu_Casa_Home_Assistant_Connect_ZBT-2_<serial-string>-if00 -> ../../ttyACM0`
|
||||
|
||||
- [ ] **Step 3: Record the by-id path**
|
||||
|
||||
Capture the value `/dev/serial/by-id/usb-Nabu_Casa_Home_Assistant_Connect_ZBT-2_<serial-string>-if00` for use in Task 4. Use the **by-id** path (not `/dev/ttyACM0`) so USB renumbering can't break OTBR.
|
||||
|
||||
---
|
||||
|
||||
### Task 4: Enable OTBR + add HA otbr/thread components
|
||||
|
||||
**Files:**
|
||||
- Modify: `modules/environments/home-assistant/default.nix`
|
||||
|
||||
- [ ] **Step 1: Write the failing eval checks**
|
||||
|
||||
On dev Mac:
|
||||
|
||||
```bash
|
||||
nix eval --json .#nixosConfigurations.jupiter.config.services.openthread-border-router.enable
|
||||
```
|
||||
|
||||
Expected: `false` (still disabled from Task 2).
|
||||
|
||||
```bash
|
||||
nix eval --json .#nixosConfigurations.jupiter.config.services.home-assistant.extraComponents
|
||||
```
|
||||
|
||||
Expected: `["matter","mobile_app"]` — no `otbr`, no `thread` yet.
|
||||
|
||||
- [ ] **Step 2: Add `"otbr"` and `"thread"` to `extraComponents`**
|
||||
|
||||
In `modules/environments/home-assistant/default.nix`, locate the `extraComponents` list (currently `[ "matter" "mobile_app" ]`) and replace it with:
|
||||
|
||||
```nix
|
||||
extraComponents = [
|
||||
"matter"
|
||||
"mobile_app"
|
||||
"otbr"
|
||||
"thread"
|
||||
];
|
||||
```
|
||||
|
||||
- [ ] **Step 3: Add the `services.openthread-border-router` block**
|
||||
|
||||
In the same file, **after** the `services.home-assistant.config = { ... };` block and **before** `my.homepage.services`, add:
|
||||
|
||||
```nix
|
||||
services.openthread-border-router = {
|
||||
enable = true;
|
||||
package = pkgs.unstable.openthread-border-router;
|
||||
openFirewall = true;
|
||||
backboneInterfaces = [ "enp3s0" ];
|
||||
radio.device = "<PASTE-BY-ID-PATH-FROM-TASK-3>";
|
||||
};
|
||||
|
||||
```
|
||||
|
||||
Replace `<PASTE-BY-ID-PATH-FROM-TASK-3>` with the literal string captured in Task 3 step 3 (e.g. `"/dev/serial/by-id/usb-Nabu_Casa_Home_Assistant_Connect_ZBT-2_AB12CD34-if00"`).
|
||||
|
||||
- [ ] **Step 4: Run the green eval checks**
|
||||
|
||||
```bash
|
||||
nix eval --json .#nixosConfigurations.jupiter.config.services.home-assistant.extraComponents
|
||||
```
|
||||
|
||||
Expected: `["matter","mobile_app","otbr","thread"]`.
|
||||
|
||||
```bash
|
||||
nix eval --json .#nixosConfigurations.jupiter.config.services.openthread-border-router.enable
|
||||
```
|
||||
|
||||
Expected: `true`.
|
||||
|
||||
```bash
|
||||
nix eval --raw .#nixosConfigurations.jupiter.config.services.openthread-border-router.radio.url
|
||||
```
|
||||
|
||||
Expected: a string like `spinel+hdlc+uart:///dev/serial/by-id/usb-Nabu_Casa_..._ZBT-2_<serial>-if00?uart-baudrate=115200` (the module composes this from `radio.device` automatically).
|
||||
|
||||
- [ ] **Step 5: Full eval — system derivation must build**
|
||||
|
||||
```bash
|
||||
nix eval .#nixosConfigurations.jupiter.config.system.build.toplevel.drvPath
|
||||
```
|
||||
|
||||
Expected: a `/nix/store/...drv` path with no eval errors.
|
||||
|
||||
- [ ] **Step 6: `nix flake check` for good measure**
|
||||
|
||||
```bash
|
||||
nix flake check
|
||||
```
|
||||
|
||||
Expected: no errors. (Same pre-existing trace warnings as before are acceptable.)
|
||||
|
||||
- [ ] **Step 7: Commit**
|
||||
|
||||
```bash
|
||||
git add modules/environments/home-assistant/default.nix
|
||||
git commit -m "$(cat <<'EOF'
|
||||
feat(home-assistant): enable OTBR for ZBT-2 + add HA otbr/thread components
|
||||
|
||||
Brings up otbr-agent against the ZBT-2 over Spinel/UART, opens the
|
||||
REST API on :8081, and wires HA's otbr + thread integrations so
|
||||
Matter-over-Thread devices can commission through the existing
|
||||
matter-server.
|
||||
|
||||
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
||||
EOF
|
||||
)"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Task 5: Operator handoff — flash OpenThread RCP firmware on the dongle
|
||||
|
||||
The dongle is currently running Zigbee NCP firmware and won't speak Spinel until reflashed. This must happen **before** Task 6's rebuild (otherwise `otbr-agent` will try to talk to a Zigbee-firmware dongle and fail).
|
||||
|
||||
**Files:** _(none on dev Mac)_
|
||||
|
||||
- [ ] **Step 1: Hand off — fetch firmware**
|
||||
|
||||
Tell the operator:
|
||||
|
||||
> "On any machine with a browser: download the latest **ZBT-2 OpenThread RCP** `.gbl` from <https://github.com/NabuCasa/silabs-firmware-builder/releases>. The asset name will look like `ot-rcp-zbt-2-<version>.gbl`. Get it onto jupiter — `scp` it over, or just `curl` from jupiter's shell. Confirm by running `ls ~/ot-rcp-zbt-2-*.gbl` on jupiter and pasting the result."
|
||||
|
||||
- [ ] **Step 2: Wait for confirmation**
|
||||
|
||||
Expected: a single matching path, e.g. `/home/finn/ot-rcp-zbt-2-2025.10.0.gbl`.
|
||||
|
||||
- [ ] **Step 3: Hand off — flash**
|
||||
|
||||
Tell the operator:
|
||||
|
||||
> "On jupiter, run (substituting the actual by-id path from Task 3 and the actual `.gbl` filename):
|
||||
>
|
||||
> ```bash
|
||||
> nix shell nixpkgs#python313Packages.universal-silabs-flasher -c \
|
||||
> universal-silabs-flasher \
|
||||
> --device /dev/serial/by-id/usb-Nabu_Casa_Home_Assistant_Connect_ZBT-2_<serial>-if00 \
|
||||
> flash --firmware ~/ot-rcp-zbt-2-<version>.gbl
|
||||
> ```
|
||||
>
|
||||
> Paste the full output. Expected duration: ~30 seconds. The tool detects the running firmware, drops the dongle into bootloader mode, writes the `.gbl`, and reboots back to RCP."
|
||||
|
||||
- [ ] **Step 4: Verify the flash succeeded**
|
||||
|
||||
Expected output ends with something like `Firmware update complete` (or equivalent success message). If the tool reports CRC failure / partial write — re-run; the bootloader stays addressable.
|
||||
|
||||
If the operator reports `--help` shows different subcommand syntax (universal-silabs-flasher's CLI has changed across versions), have them check `universal-silabs-flasher --help` and adapt — but the `flash --firmware <path>` form has been stable since 1.0.x.
|
||||
|
||||
---
|
||||
|
||||
### Task 6: Operator handoff — `nixos-rebuild switch` on jupiter
|
||||
|
||||
**Files:** _(none on dev Mac)_
|
||||
|
||||
- [ ] **Step 1: Push the branch so jupiter can fetch it**
|
||||
|
||||
On dev Mac:
|
||||
|
||||
```bash
|
||||
git push -u origin feature/ha-zbt-2-thread
|
||||
```
|
||||
|
||||
(If the operator pulls via a different mechanism — local checkout, fileshare — adapt accordingly. The standard pattern in this repo is `git pull` on jupiter.)
|
||||
|
||||
- [ ] **Step 2: Hand off — pull + rebuild**
|
||||
|
||||
Tell the operator:
|
||||
|
||||
> "On jupiter:
|
||||
>
|
||||
> ```bash
|
||||
> cd ~/development/nixos # or wherever the flake lives on jupiter
|
||||
> git fetch origin
|
||||
> git checkout feature/ha-zbt-2-thread
|
||||
> sudo nixos-rebuild switch --flake .#jupiter
|
||||
> ```
|
||||
>
|
||||
> Paste the tail of the output (everything from the first `building ...` line onward). Expected: build completes, switch to the new generation, no errors."
|
||||
|
||||
- [ ] **Step 3: Verify the switch succeeded**
|
||||
|
||||
If the operator's pasted output includes `error:` or the switch failed mid-activation, **stop here**. Common failure: option name mismatch with whatever version of nixos-unstable is locked in the flake. Fix on dev Mac, push, ask operator to pull + rebuild again.
|
||||
|
||||
If the rebuild succeeded, proceed to Task 7.
|
||||
|
||||
---
|
||||
|
||||
### Task 7: Operator handoff — service-level verification on jupiter
|
||||
|
||||
**Files:** _(none)_
|
||||
|
||||
- [ ] **Step 1: Hand off — service health**
|
||||
|
||||
Tell the operator:
|
||||
|
||||
> "On jupiter, run each command and paste output:
|
||||
>
|
||||
> ```bash
|
||||
> systemctl status otbr-agent.service --no-pager
|
||||
> journalctl -u otbr-agent.service -n 50 --no-pager
|
||||
> ip link show wpan0
|
||||
> ```"
|
||||
|
||||
- [ ] **Step 2: Verify**
|
||||
|
||||
Expected:
|
||||
- `systemctl status` reports `active (running)`.
|
||||
- `journalctl` shows OTBR startup messages, no repeated restart loops.
|
||||
- `ip link show wpan0` shows the interface exists; state DOWN is correct (HA hasn't formed a network yet).
|
||||
|
||||
If `otbr-agent` is in restart loop with `Failed to open device`: device path mismatch. Re-check Task 3's path.
|
||||
|
||||
- [ ] **Step 3: Hand off — mDNS publication**
|
||||
|
||||
Tell the operator:
|
||||
|
||||
> "On jupiter:
|
||||
>
|
||||
> ```bash
|
||||
> avahi-browse -r -t _meshcop._udp
|
||||
> ```"
|
||||
|
||||
Expected: one entry whose hostname matches jupiter, advertising port 8081.
|
||||
|
||||
If empty: `backboneInterfaces` is wrong. On jupiter, run `ip link show` and tell operator to paste; pick the actual primary LAN interface, update `backboneInterfaces`, re-rebuild.
|
||||
|
||||
- [ ] **Step 4: Hand off — REST API reachability**
|
||||
|
||||
Tell the operator:
|
||||
|
||||
> "On jupiter:
|
||||
>
|
||||
> ```bash
|
||||
> curl -s http://127.0.0.1:8081/node/state
|
||||
> ```"
|
||||
|
||||
Expected: a JSON state string, most likely `"disabled"` (HA hasn't formed a network yet).
|
||||
|
||||
If connection refused: OTBR isn't actually listening — re-check `journalctl`.
|
||||
|
||||
---
|
||||
|
||||
### Task 8: Operator handoff — HA UI smoke test
|
||||
|
||||
**Files:** _(none)_
|
||||
|
||||
- [ ] **Step 1: Hand off — confirm discovery**
|
||||
|
||||
Tell the operator:
|
||||
|
||||
> "Open `http://jupiter:8123` in a browser. Go to **Settings → Devices & Services**. Within ~30s of the rebuild, you should see **'Open Thread Border Router'** under 'Discovered'. Click **Configure**. Let HA form a new Thread network (or import existing dataset if you have one). Tell me when that's done — and paste any errors if it doesn't work."
|
||||
|
||||
- [ ] **Step 2: Wait for confirmation**
|
||||
|
||||
Expected: HA reports the Thread network is formed; the OTBR integration appears under 'Configured'.
|
||||
|
||||
If discovery doesn't happen: cross-check with Task 7 step 3 (`avahi-browse`). HA reads from the system's avahi cache.
|
||||
|
||||
- [ ] **Step 3: Hand off — Matter-over-Thread pairing**
|
||||
|
||||
Tell the operator:
|
||||
|
||||
> "Pick one Matter-over-Thread device. Use the HA Companion app, scan its Matter QR code, and follow the prompts. Tell me when it's paired — or paste any errors. Pairing should complete in 30–90s."
|
||||
|
||||
- [ ] **Step 4: Wait for confirmation**
|
||||
|
||||
Expected: device appears under both Matter and Thread integrations in HA, and is controllable from the dashboard.
|
||||
|
||||
If pairing times out: see "Failure modes" table in the spec — most likely Thread mesh prefix isn't routed back to LAN. Operator runs `nft list ruleset` and `ip -6 route` on jupiter; debug from there.
|
||||
|
||||
---
|
||||
|
||||
### Task 9: Merge to master
|
||||
|
||||
**Files:** _(none)_
|
||||
|
||||
- [ ] **Step 1: Final branch state**
|
||||
|
||||
On dev Mac:
|
||||
|
||||
```bash
|
||||
git log --oneline master..feature/ha-zbt-2-thread
|
||||
```
|
||||
|
||||
Expected (in chronological order from oldest to newest):
|
||||
1. `e8d09f4` — original ZHA commit
|
||||
2. `dbeda27` — design spec
|
||||
3. `<revert hash>` — Revert "feat(home-assistant): enable ZHA for ZBT-2 Zigbee dongle"
|
||||
4. `<task-2 hash>` — feat(home-assistant): import openthread-border-router module from unstable
|
||||
5. `<task-4 hash>` — feat(home-assistant): enable OTBR for ZBT-2 + add HA otbr/thread components
|
||||
|
||||
That's a fine history to merge as-is (the ZHA→revert pair is honest about the pivot).
|
||||
|
||||
- [ ] **Step 2: Hand off — merge**
|
||||
|
||||
The user runs the merge themselves (per repo policy: never commit to master without explicit consent). Tell the operator:
|
||||
|
||||
> "If the smoke tests in Task 8 worked, merge with:
|
||||
>
|
||||
> ```bash
|
||||
> git switch master
|
||||
> git merge --no-ff feature/ha-zbt-2-thread
|
||||
> git push origin master
|
||||
> ```
|
||||
>
|
||||
> Or open a merge request / PR if you prefer review first."
|
||||
|
||||
- [ ] **Step 3: Optional cleanup**
|
||||
|
||||
After merge:
|
||||
|
||||
```bash
|
||||
git branch -d feature/ha-zbt-2-thread
|
||||
git push origin --delete feature/ha-zbt-2-thread
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Self-Review
|
||||
|
||||
**Spec coverage:**
|
||||
- Goals (4 bullets) → Tasks 2 (OTBR module wiring), 4 (OTBR enable + HA components), 5 (firmware flash), 8 (Matter-over-Thread smoke test) ✓
|
||||
- Non-goals → respected; no multipan, no auto-flash, no fallback paths ✓
|
||||
- Architecture diagram → Task 4 produces the wiring shown; Tasks 6–8 verify it ✓
|
||||
- File changes (one module) → Tasks 1, 2, 4 ✓
|
||||
- Reverts of prior ZHA commit → Task 1 ✓
|
||||
- Operator workflow steps 0–7 → Tasks 1, 2, 3, 4, 5, 6, 7, 8 ✓
|
||||
- Verification (eval-only / service-level / functional) → Tasks 2/4/6/7/8 ✓
|
||||
- Failure-mode table → referenced in Tasks 6, 7, 8 for triage ✓
|
||||
|
||||
**Placeholder scan:**
|
||||
- `<PASTE-BY-ID-PATH-FROM-TASK-3>` in Task 4 step 3 is intentional — it's a runtime parameter the operator fills in, captured in Task 3.
|
||||
- `<serial>`, `<version>` in shell commands are intentional placeholders for operator substitution.
|
||||
- No "TBD", "TODO", "implement later", or vague "handle errors" steps.
|
||||
|
||||
**Type / name consistency:**
|
||||
- `services.openthread-border-router` used consistently (matches the unstable module's option path).
|
||||
- `pkgs.unstable.openthread-border-router` matches the overlay (`machines/configuration.nix:11`).
|
||||
- `extraComponents` strings (`"otbr"`, `"thread"`) match HA Core integration names.
|
||||
- `radio.device` ↔ `radio.url` relationship documented (module composes `url` from `device`).
|
||||
@@ -0,0 +1,232 @@
|
||||
# MiBook Claude Code Module Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
**Goal:** Add a `my.profiles.claude-code` NixOS module that installs the Claude Code CLI and companion tooling on the MiBook.
|
||||
|
||||
**Architecture:** A single new environment module (`modules/environments/claude-code/default.nix`) declares the `my.profiles.claude-code.enable` option and installs packages for user `finn`. It is registered in `modules/environments/default.nix` and toggled on in `machines/mibook/environments.nix`.
|
||||
|
||||
**Tech Stack:** Nix flakes, NixOS module system, `pkgs.unstable` overlay (already present in repo)
|
||||
|
||||
---
|
||||
|
||||
## File Map
|
||||
|
||||
| Action | Path | Responsibility |
|
||||
|---|---|---|
|
||||
| Create | `modules/environments/claude-code/default.nix` | Declares option + installs packages |
|
||||
| Modify | `modules/environments/default.nix` | Registers the new module so NixOS loads it |
|
||||
| Modify | `machines/mibook/environments.nix` | Enables the profile for the MiBook host |
|
||||
|
||||
---
|
||||
|
||||
### Task 1: Verify `claude-code` exists in `nixpkgs-unstable`
|
||||
|
||||
**Files:**
|
||||
- Read-only check — no file changes
|
||||
|
||||
- [ ] **Step 1: Check if the package is available**
|
||||
|
||||
Run:
|
||||
```bash
|
||||
nix eval --extra-experimental-features 'nix-command flakes' 'github:NixOS/nixpkgs/nixos-unstable#claude-code.version' 2>&1
|
||||
```
|
||||
|
||||
Expected (success): prints a version string like `"0.2.x"`
|
||||
|
||||
Expected (failure): `error: attribute 'claude-code' missing`
|
||||
|
||||
- [ ] **Step 2: If the package exists — note the attribute path and continue to Task 2**
|
||||
|
||||
The module will use `pkgs.unstable.claude-code`.
|
||||
|
||||
- [ ] **Step 3: If the package does NOT exist — add a custom derivation first**
|
||||
|
||||
Create `pkgs/claude-code/default.nix`:
|
||||
```nix
|
||||
{ lib, buildNpmPackage, fetchFromGitHub }:
|
||||
buildNpmPackage rec {
|
||||
pname = "claude-code";
|
||||
version = "0.2.116"; # update to latest release tag
|
||||
|
||||
src = fetchFromGitHub {
|
||||
owner = "anthropics";
|
||||
repo = "claude-code";
|
||||
rev = "v${version}";
|
||||
hash = lib.fakeHash; # run nix build to get real hash
|
||||
};
|
||||
|
||||
npmDepsHash = lib.fakeHash; # run nix build to get real hash
|
||||
|
||||
meta = {
|
||||
description = "Claude Code CLI by Anthropic";
|
||||
homepage = "https://github.com/anthropics/claude-code";
|
||||
license = lib.licenses.unfree;
|
||||
mainProgram = "claude";
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
Then register it in `pkgs/default.nix`:
|
||||
```nix
|
||||
final: prev: {
|
||||
claude-code = final.callPackage ./claude-code { };
|
||||
}
|
||||
```
|
||||
|
||||
And use `pkgs.claude-code` (not `pkgs.unstable.claude-code`) in the module.
|
||||
|
||||
---
|
||||
|
||||
### Task 2: Create the `claude-code` module
|
||||
|
||||
**Files:**
|
||||
- Create: `modules/environments/claude-code/default.nix`
|
||||
|
||||
- [ ] **Step 1: Create the module file**
|
||||
|
||||
Create `modules/environments/claude-code/default.nix` with this exact content:
|
||||
```nix
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.claude-code;
|
||||
in
|
||||
{
|
||||
options.my.profiles.claude-code = with lib; {
|
||||
enable = mkEnableOption "Claude Code CLI";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
users.users.finn.packages = with pkgs; [
|
||||
unstable.claude-code
|
||||
ripgrep
|
||||
fd
|
||||
gh
|
||||
jq
|
||||
];
|
||||
|
||||
# Future: headless Claude Code service
|
||||
# A natural next step is exposing Claude Code as a persistent background service —
|
||||
# e.g. a systemd user service that accepts work via an HTTP API or Unix socket,
|
||||
# triggerable over SSH or a local network endpoint. This would turn the MiBook
|
||||
# into a true remote execution node without requiring an interactive session.
|
||||
# See: my.profiles.claude-code.service.enable (not yet implemented)
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
> Note: if Task 1 Step 3 was taken (custom derivation), replace `unstable.claude-code` with `claude-code`.
|
||||
|
||||
---
|
||||
|
||||
### Task 3: Register the module
|
||||
|
||||
**Files:**
|
||||
- Modify: `modules/environments/default.nix`
|
||||
|
||||
- [ ] **Step 1: Add the import**
|
||||
|
||||
In `modules/environments/default.nix`, add `./claude-code` to the imports list (alphabetical order puts it between `./audiobookshelf` and `./development`):
|
||||
|
||||
```nix
|
||||
{ ... }:
|
||||
{
|
||||
imports = [
|
||||
./actual
|
||||
./apps
|
||||
./audiobookshelf
|
||||
./claude-code
|
||||
./development
|
||||
./home-assistant
|
||||
./hyprland
|
||||
./zsh
|
||||
./paperless
|
||||
./prowlarr
|
||||
./radarr
|
||||
./docker
|
||||
./homepage
|
||||
./kde-desktop
|
||||
./readarr
|
||||
./sonarr
|
||||
./jellyfin
|
||||
./jellyseerr
|
||||
];
|
||||
}
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Verify the option is now defined (without enabling it)**
|
||||
|
||||
Run:
|
||||
```bash
|
||||
nix eval --extra-experimental-features 'nix-command flakes' '.#nixosConfigurations.mibook.options.my.profiles.claude-code.enable.description'
|
||||
```
|
||||
|
||||
Expected: `"Whether to enable Claude Code CLI."`
|
||||
|
||||
If this errors, the module isn't loading — re-check the import path.
|
||||
|
||||
---
|
||||
|
||||
### Task 4: Enable on MiBook and verify the build
|
||||
|
||||
**Files:**
|
||||
- Modify: `machines/mibook/environments.nix`
|
||||
|
||||
- [ ] **Step 1: Enable the profile**
|
||||
|
||||
In `machines/mibook/environments.nix`, add `claude-code.enable = true` inside the `my.profiles` block:
|
||||
|
||||
```nix
|
||||
my.profiles = {
|
||||
kde-desktop.enable = true;
|
||||
zsh.enable = true;
|
||||
apps = {
|
||||
desktop_apps = true;
|
||||
dev_apps = true;
|
||||
};
|
||||
development.enable = true;
|
||||
docker.enable = true;
|
||||
claude-code.enable = true;
|
||||
};
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Verify the package appears in finn's user packages**
|
||||
|
||||
Run:
|
||||
```bash
|
||||
nix eval --extra-experimental-features 'nix-command flakes' '.#nixosConfigurations.mibook.config.users.users.finn.packages' --apply 'builtins.map (p: p.name)' 2>&1 | grep -i claude
|
||||
```
|
||||
|
||||
Expected: a line containing `claude-code-<version>`
|
||||
|
||||
- [ ] **Step 3: Dry-run build to confirm the full config evaluates**
|
||||
|
||||
Run:
|
||||
```bash
|
||||
nix build '.#nixosConfigurations.mibook.config.system.build.toplevel' --extra-experimental-features 'nix-command flakes' --dry-run 2>&1 | tail -5
|
||||
```
|
||||
|
||||
Expected: exits 0, output lists derivations to build (or "nothing to do" if already cached). No evaluation errors.
|
||||
|
||||
---
|
||||
|
||||
### Task 5: Commit
|
||||
|
||||
**Files:**
|
||||
- All changed files from Tasks 1–4
|
||||
|
||||
- [ ] **Step 1: Stage and commit**
|
||||
|
||||
```bash
|
||||
git add modules/environments/claude-code/default.nix \
|
||||
modules/environments/default.nix \
|
||||
machines/mibook/environments.nix
|
||||
git commit -m "feat(mibook): add claude-code profile module"
|
||||
```
|
||||
|
||||
If Task 1 Step 3 was taken, also stage `pkgs/claude-code/default.nix` and `pkgs/default.nix`.
|
||||
@@ -0,0 +1,241 @@
|
||||
# ZBT-2 as a Thread Border Router for Home Assistant on `jupiter`
|
||||
|
||||
**Date:** 2026-05-10
|
||||
**Branch:** `feature/ha-zbt-2-thread`
|
||||
**Status:** Design — pending implementation plan
|
||||
|
||||
## Context
|
||||
|
||||
Home Assistant on `jupiter` already runs natively (`services.home-assistant`) with the Matter integration and `services.matter-server` enabled, but has no Zigbee or Thread radio. The user has acquired a **Home Assistant Connect ZBT-2** (Nabu Casa's Silicon Labs EFR32MG24‑based USB Zigbee/Thread radio).
|
||||
|
||||
The user wants the dongle running as an **OpenThread Border Router (OTBR)** — Thread only, not Zigbee — so Matter-over-Thread devices can be onboarded through the existing HA Matter integration.
|
||||
|
||||
A previous iteration of this work shipped `zha` enablement on the same branch (commit `e8d09f4`). That commit will be reverted as part of implementation; this design supersedes it.
|
||||
|
||||
## Goals
|
||||
|
||||
- Bring up `otbr-agent` on jupiter against the ZBT-2.
|
||||
- Have Home Assistant auto-discover the OTBR via mDNS and use its REST API to manage the Thread network.
|
||||
- Have `services.matter-server` (already enabled) consume Thread credentials from HA so Matter-over-Thread devices commission through the ZBT-2.
|
||||
- One-time, manual firmware flash from Zigbee NCP to OpenThread RCP via `universal-silabs-flasher` (option B from brainstorming — no HA-driven update flow).
|
||||
|
||||
## Non-goals
|
||||
|
||||
- **Multipan / multiprotocol** (Zigbee + Thread on one radio). Out of scope; the dongle will be Thread-only.
|
||||
- **Falling back to ZHA** if Thread misbehaves. Thread-only by choice; if it fails the response is to debug, not to dual-stack.
|
||||
- **HA-UI-driven firmware updates.** The HAOS "Silicon Labs Multiprotocol" add-on workflow doesn't translate to native NixOS without faking a supervisor; the user explicitly accepted CLI-only flashing.
|
||||
- **Thread network credential backups.** HA owns the dataset; standard HA backup hygiene (separate concern) covers it.
|
||||
|
||||
## Architecture
|
||||
|
||||
```
|
||||
┌────────────────────────── jupiter (NixOS) ──────────────────────────┐
|
||||
│ │
|
||||
ZBT-2 USB ──►│ /dev/serial/by-id/usb-Nabu_Casa_..._ZBT-2_<serial>-... │
|
||||
│ │ │
|
||||
│ │ spinel+hdlc+uart, 115200 baud │
|
||||
│ ▼ │
|
||||
│ ┌───────────────┐ REST :8081 (loopback) ┌──────────────────┐ │
|
||||
│ │ otbr-agent │ ◄─────────────────────►│ home-assistant │ │
|
||||
│ │ (systemd) │ │ + matter-server │ │
|
||||
│ │ wpan0 ───────┼── advertises via ─┐ │ extraComponents:│ │
|
||||
│ └───────────────┘ avahi (_meshcop) │ │ matter, │ │
|
||||
│ ▼ │ mobile_app, │ │
|
||||
│ enp3s0 (LAN — backbone) │ otbr, thread │ │
|
||||
│ └──────────────────┘ │
|
||||
└────────────────────────────────────┬──────────────────────────────────┘
|
||||
│
|
||||
home LAN ◄─┘
|
||||
(Matter-over-Thread devices join here)
|
||||
```
|
||||
|
||||
### Components
|
||||
|
||||
1. **The radio.** ZBT-2, USB-attached, running OpenThread RCP firmware after a one-time flash.
|
||||
2. **`otbr-agent`** (systemd). Managed by the unstable `services.openthread-border-router` NixOS module imported via `inputs.nixpkgs-unstable`. Owns `wpan0`, talks Spinel to the dongle, exposes the OTBR REST API on `127.0.0.1:8081`, advertises `_meshcop._udp` over `enp3s0` via avahi.
|
||||
3. **Home Assistant** (already running). Gains the `otbr` and `thread` extra components. Discovers OTBR via mDNS, drives the REST API, supplies Thread operational datasets to `matter-server` during Matter commissioning.
|
||||
|
||||
### Data flows
|
||||
|
||||
- **OTBR ↔ ZBT-2:** Spinel-over-HDLC over UART. Built automatically by the module from `radio.device` as `spinel+hdlc+uart://<device>?uart-baudrate=115200`.
|
||||
- **HA ↔ OTBR:** mDNS discovery (`_meshcop._udp`) → REST calls to `127.0.0.1:8081` for network management.
|
||||
- **Matter commissioning:** HA scans QR → `matter-server` does BLE commissioning → asks HA for Thread dataset → HA fetches from OTBR → ships to device → device joins Thread mesh through the ZBT-2.
|
||||
|
||||
HA never opens the serial port directly; `matter-server` never talks to OTBR directly. HA brokers between them — that's why all four extra components are needed.
|
||||
|
||||
## NixOS-side changes
|
||||
|
||||
All changes live in **`modules/environments/home-assistant/default.nix`**. No host-level changes in `machines/jupiter/` (the existing profile activation handles that), no flake-level changes (the existing `_module.args.self = self;` wiring is sufficient).
|
||||
|
||||
### Edited module sketch
|
||||
|
||||
```nix
|
||||
{ config, lib, pkgs, self, ... }:
|
||||
let
|
||||
cfg = config.my.profiles.home-assistant;
|
||||
hostName = config.networking.hostName;
|
||||
in
|
||||
{
|
||||
imports = [
|
||||
# OTBR module isn't in 25.11 yet; use unstable's directly. Package
|
||||
# comes from the existing `unstable` overlay.
|
||||
"${self.inputs.nixpkgs-unstable}/nixos/modules/services/home-automation/openthread-border-router.nix"
|
||||
];
|
||||
|
||||
options.my.profiles.home-assistant.enable = lib.mkEnableOption "Home Automation";
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.matter-server.enable = true;
|
||||
|
||||
services.home-assistant = {
|
||||
enable = true;
|
||||
openFirewall = true;
|
||||
extraComponents = [
|
||||
"matter"
|
||||
"mobile_app"
|
||||
"otbr"
|
||||
"thread"
|
||||
];
|
||||
};
|
||||
|
||||
services.home-assistant.config = {
|
||||
name = "Home - Rechberg";
|
||||
unit_system = "metric";
|
||||
mobile_app = { };
|
||||
};
|
||||
|
||||
services.openthread-border-router = {
|
||||
enable = true;
|
||||
package = pkgs.unstable.openthread-border-router;
|
||||
openFirewall = true;
|
||||
backboneInterfaces = [ "enp3s0" ]; # verify with `ip link` post-deploy
|
||||
radio.device = "/dev/serial/by-id/usb-Nabu_Casa_Home_Assistant_Connect_ZBT-2_<serial>-...";
|
||||
# web.enable left default (off) — HA UI is the management surface
|
||||
};
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Services";
|
||||
name = "Home Assistant";
|
||||
description = "Home automation";
|
||||
href = "http://${hostName}:8123";
|
||||
icon = "si-homeassistant";
|
||||
}
|
||||
];
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
### Reverts of the prior ZHA commit
|
||||
|
||||
Drop both lines from commit `e8d09f4`:
|
||||
|
||||
- `"zha"` from `extraComponents` (replaced by `"otbr"` + `"thread"`).
|
||||
- `users.users.hass.extraGroups = [ "dialout" ];` — `otbr-agent` runs as root and owns the device directly; HA never opens the serial port itself.
|
||||
|
||||
Done by `git revert e8d09f4` at the start of implementation, before applying the new diff.
|
||||
|
||||
### Decisions captured
|
||||
|
||||
- **No `universal-silabs-flasher` in `environment.systemPackages`.** Flashing is a once-or-twice-a-year operation; `nix shell nixpkgs#python313Packages.universal-silabs-flasher` is sufficient when needed and avoids a perma-dep on a tool that's idle most of the time.
|
||||
- **No firmware pinning in the flake.** Consistent with option B (CLI-only manual flashing). The user fetches the `.gbl` from <https://github.com/NabuCasa/silabs-firmware-builder/releases> at update time.
|
||||
- **`backboneInterfaces = [ "enp3s0" ]`** as a starting value (per `machines/jupiter/hardware-configuration.nix:64`). To be verified against `ip link` after first deploy; correctable in a follow-up commit if the actual primary interface differs.
|
||||
|
||||
## Operator workflow
|
||||
|
||||
All commands the user runs themselves; nothing is SSH'd from the dev session.
|
||||
|
||||
### Step 0 — branch hygiene (dev Mac)
|
||||
```
|
||||
git switch feature/ha-zbt-2-thread # already renamed
|
||||
git revert --no-edit e8d09f4 # drops ZHA + dialout commit
|
||||
```
|
||||
|
||||
### Step 1 — apply the module changes (dev Mac)
|
||||
Edit `modules/environments/home-assistant/default.nix` per the sketch above. Leave `<serial>` as a placeholder; fill after Step 3.
|
||||
|
||||
### Step 2 — eval-only sanity check (dev Mac)
|
||||
```
|
||||
nix flake check
|
||||
```
|
||||
or, equivalently,
|
||||
```
|
||||
nixos-rebuild dry-build --flake .#jupiter
|
||||
```
|
||||
Catches: bad import path, option typos, version skew between unstable and stable.
|
||||
|
||||
### Step 3 — plug ZBT-2 into jupiter (still on stock Zigbee firmware)
|
||||
On jupiter:
|
||||
```
|
||||
ls -l /dev/serial/by-id/
|
||||
```
|
||||
Then on dev Mac: copy the full `usb-Nabu_Casa_Home_Assistant_Connect_ZBT-2_<serial>-...` path into `radio.device`, commit on the feature branch.
|
||||
|
||||
### Step 4 — flash OpenThread RCP firmware (one-time, on jupiter)
|
||||
```
|
||||
nix shell nixpkgs#python313Packages.universal-silabs-flasher -c \
|
||||
universal-silabs-flasher \
|
||||
--device /dev/serial/by-id/usb-Nabu_Casa_Home_Assistant_Connect_ZBT-2_<serial>-... \
|
||||
flash --firmware ~/ot-rcp-zbt-2-<version>.gbl
|
||||
```
|
||||
Firmware download: latest ZBT-2 OpenThread RCP `.gbl` from <https://github.com/NabuCasa/silabs-firmware-builder/releases>.
|
||||
|
||||
OTBR isn't running yet at this point, so there's no contention on the device.
|
||||
|
||||
### Step 5 — rebuild (on jupiter)
|
||||
```
|
||||
sudo nixos-rebuild switch --flake .#jupiter
|
||||
```
|
||||
Brings up `otbr-agent.service`, opens TCP/8081, loads `otbr` + `thread` integrations in HA.
|
||||
|
||||
### Step 6 — confirm HA discovered it
|
||||
- `http://jupiter:8123` → Settings → Devices & Services → "Open Thread Border Router" appears as auto-discovered within ~30 s.
|
||||
- Click "Configure", form a new Thread network (or import an existing dataset).
|
||||
- "Matter" integration page now shows Thread credentials available.
|
||||
|
||||
### Step 7 — Matter-over-Thread smoke test
|
||||
Pair one Matter-over-Thread device end-to-end via the HA Companion app. Pairing should complete in 30–90 s. If it does, merge `feature/ha-zbt-2-thread` into `master`.
|
||||
|
||||
### Future updates
|
||||
Identical to Step 4: stop `otbr-agent.service`, run the flasher with a new `.gbl`, start the service.
|
||||
|
||||
## Failure modes
|
||||
|
||||
| Symptom | Likely cause | Mitigation |
|
||||
|---|---|---|
|
||||
| `otbr-agent.service` fails: "Failed to open device" | Dongle unplugged or `radio.device` path stale (e.g. after replacement) | Module sets `Restart = "on-failure"`; check `systemctl status otbr-agent`, re-check `/dev/serial/by-id/`, update path. |
|
||||
| OTBR up but HA never discovers it | mDNS not propagating on `enp3s0` (most often: `backboneInterfaces` wrong) | `avahi-browse -r _meshcop._udp` should show one entry. If not: `ip link`, fix `backboneInterfaces`, rebuild. |
|
||||
| HA shows OTBR but Matter pairing times out | Thread mesh prefix not routed to LAN, or matter-server can't reach the device's IPv6 ULA | `nft list ruleset` should show OTBR's forwarding rules; `ip -6 route` should include the Thread mesh prefix. |
|
||||
| Dongle stuck after a half-completed flash | Flasher interrupted mid-write | Re-run the flash; bootloader stays addressable even if RCP firmware is corrupt. The tool detects bootloader-mode automatically. |
|
||||
| `nixos-rebuild` fails: "option `services.openthread-border-router` does not exist" | Unstable module import path wrong / not in scope | Caught by Step 2 (eval-only). Fix before deploy. |
|
||||
|
||||
## Verification
|
||||
|
||||
### Eval-only (dev Mac, before deploy)
|
||||
```
|
||||
nix flake check
|
||||
nix eval --json .#nixosConfigurations.jupiter.config.services.openthread-border-router.radio.url
|
||||
nix eval --json .#nixosConfigurations.jupiter.config.services.home-assistant.extraComponents
|
||||
```
|
||||
Expected: flake check passes; `radio.url` is a `spinel+hdlc+uart://...` string built from the by-id path; `extraComponents` includes `"otbr"` and `"thread"`.
|
||||
|
||||
### Service-level (jupiter, after rebuild)
|
||||
```
|
||||
systemctl status otbr-agent.service
|
||||
journalctl -u otbr-agent.service -n 50 --no-pager
|
||||
ip link show wpan0
|
||||
avahi-browse -r -t _meshcop._udp
|
||||
curl -s http://127.0.0.1:8081/node/state
|
||||
```
|
||||
Expected: service active; `wpan0` exists (DOWN until HA forms a network — correct); one `_meshcop._udp` entry; REST returns a JSON state string.
|
||||
|
||||
### Functional (HA UI)
|
||||
- "Open Thread Border Router" appears under auto-discovered integrations.
|
||||
- Forming a Thread network from the integration UI succeeds.
|
||||
- Pairing one Matter-over-Thread device end-to-end succeeds.
|
||||
|
||||
## Open questions / risks
|
||||
|
||||
- **Unstable module ABI.** The `services.openthread-border-router` module is in `nixos-unstable` and may change shape before landing in 26.05. If options rename, the eval-only step catches it before deploy. Acceptable risk; we can pin the unstable input revision if churn becomes annoying.
|
||||
- **Backbone interface name.** `enp3s0` is a best guess from `hardware-configuration.nix:64`'s commented-out line. Definitive answer comes from `ip link` on the actual host. Trivial to correct if wrong.
|
||||
- **First-flash chicken-and-egg.** Deferred to `nix shell` rather than baked into the system, because the dongle must be flashed *before* `otbr-agent` claims it. This is documented in Step 4.
|
||||
@@ -0,0 +1,111 @@
|
||||
# Smartphone push notifications from Home Assistant
|
||||
|
||||
## Goal
|
||||
|
||||
Send push notifications from jupiter's Home Assistant to the user's
|
||||
smartphones over the home Tailscale (Headscale) tailnet `solar.internal`.
|
||||
|
||||
## Architecture
|
||||
|
||||
- HA's `mobile_app` integration is enabled (already in `extraComponents`
|
||||
and present as `mobile_app = {}` in config).
|
||||
- Each smartphone runs the **HA Companion app**, signs in to HA, and
|
||||
auto-registers as a `notify.mobile_app_<device_slug>` service.
|
||||
- Reach: phones connect to HA via Tailscale, so HA's `external_url` is
|
||||
set to the Headscale FQDN `http://jupiter.solar.internal:8123`. The
|
||||
`internal_url` is `http://jupiter:8123` for LAN-attached devices.
|
||||
- No public exposure, no reverse proxy, no TLS termination in scope.
|
||||
|
||||
## Phase A — done in this branch
|
||||
|
||||
NixOS module change in `modules/environments/home-assistant/default.nix`:
|
||||
|
||||
```nix
|
||||
homeassistant = {
|
||||
name = "Home - Rechberg";
|
||||
unit_system = "metric";
|
||||
internal_url = "http://${hostName}:8123";
|
||||
external_url = "http://jupiter.solar.internal:8123";
|
||||
};
|
||||
```
|
||||
|
||||
After deploy, perform the user-side registration:
|
||||
|
||||
1. Install the Companion app:
|
||||
- iOS: search "Home Assistant" in the App Store.
|
||||
- Android: search "Home Assistant" in Google Play.
|
||||
2. Ensure Tailscale is running and connected on the phone.
|
||||
3. Open the Companion app. When asked to connect, enter
|
||||
`http://jupiter.solar.internal:8123` and sign in with the HA account.
|
||||
4. Approve the registration prompt in HA.
|
||||
5. In HA, go to **Settings → Devices & Services → Mobile App** and
|
||||
confirm the phone appears as a device.
|
||||
6. In HA, go to **Developer Tools → Services**, type `notify.mobile_app_`
|
||||
and note the exact service slug for each phone (e.g.
|
||||
`notify.mobile_app_iphone_finn`). These slugs are needed for Phase B.
|
||||
|
||||
### Verifying Phase A end-to-end
|
||||
|
||||
Build-time:
|
||||
|
||||
```
|
||||
nix eval '.#nixosConfigurations.jupiter.config.services.home-assistant.config.homeassistant' \
|
||||
--extra-experimental-features 'nix-command flakes'
|
||||
```
|
||||
|
||||
Expect the rendered attrset to contain both `external_url` and
|
||||
`internal_url`.
|
||||
|
||||
Deploy on jupiter:
|
||||
|
||||
```
|
||||
sudo nixos-rebuild switch --flake '.#jupiter'
|
||||
systemctl status home-assistant
|
||||
journalctl -u home-assistant -n 50 --no-pager
|
||||
```
|
||||
|
||||
Functional check after Companion sign-in:
|
||||
|
||||
- HA UI → **Developer Tools → Services** → choose
|
||||
`notify.mobile_app_<your_device>` → service data
|
||||
`{ "message": "Phase A test" }` → **Call Service** → push arrives on
|
||||
the phone.
|
||||
|
||||
## Phase B — follow-up commit (after registration)
|
||||
|
||||
Once device slugs are known, a separate commit adds:
|
||||
|
||||
1. A `notify` group fanning out to every registered phone:
|
||||
|
||||
```nix
|
||||
notify = [
|
||||
{
|
||||
name = "all_phones";
|
||||
platform = "group";
|
||||
services = [
|
||||
{ service = "mobile_app_<slug_1>"; }
|
||||
{ service = "mobile_app_<slug_2>"; }
|
||||
];
|
||||
}
|
||||
];
|
||||
```
|
||||
|
||||
2. A smoke-test mechanism. Approach to be decided in Phase B based on
|
||||
whether future Nix-managed automations are expected:
|
||||
|
||||
- Pragmatic: document a one-time UI call to `notify.all_phones` from
|
||||
Developer Tools (no automation in YAML).
|
||||
- Compromise: switch `automation = "!include automations.yaml"` to
|
||||
`!include_dir_merge_list automations/` so a Nix-managed
|
||||
`00-smoke-test.yaml` can coexist with UI-editable automations.
|
||||
|
||||
### Verifying Phase B end-to-end
|
||||
|
||||
- Restart HA, watch `journalctl -u home-assistant` for YAML schema errors.
|
||||
- Call `notify.all_phones` from Developer Tools — every registered phone
|
||||
receives the push.
|
||||
|
||||
## Open items
|
||||
|
||||
- After Companion registration, collect the `mobile_app_<slug>` service
|
||||
names from HA and update this spec + open Phase B PR.
|
||||
@@ -0,0 +1,61 @@
|
||||
# MiBook Claude Code Execution Machine
|
||||
|
||||
**Date:** 2026-05-25
|
||||
**Branch:** feature/ha-zbt-2-thread
|
||||
**Status:** Approved
|
||||
|
||||
## Goal
|
||||
|
||||
Configure the MiBook as an interactive Claude Code execution machine by installing the Claude Code CLI and its companion tooling via a new, independently-toggleable NixOS profile module.
|
||||
|
||||
## Scope
|
||||
|
||||
Phase 1 (this spec): interactive CLI session — user logs in or SSHs in and runs `claude` directly.
|
||||
|
||||
Phase 2 (future): headless systemd user service exposing Claude Code over an HTTP API or Unix socket, turning the MiBook into a remotely-triggerable execution node without an interactive session.
|
||||
|
||||
## Module Structure
|
||||
|
||||
```
|
||||
modules/environments/claude-code/default.nix ← new module
|
||||
modules/environments/default.nix ← add import
|
||||
machines/mibook/environments.nix ← my.profiles.claude-code.enable = true
|
||||
```
|
||||
|
||||
Follows the exact same pattern as every other environment module in this repo.
|
||||
|
||||
## Option Declaration
|
||||
|
||||
```
|
||||
my.profiles.claude-code.enable (mkEnableOption)
|
||||
```
|
||||
|
||||
No sub-options for Phase 1. Phase 2 would add `my.profiles.claude-code.service.enable`.
|
||||
|
||||
## Packages (users.users.finn.packages)
|
||||
|
||||
| Package | Source | Purpose |
|
||||
|---|---|---|
|
||||
| `claude-code` | `pkgs.unstable` | Claude Code CLI |
|
||||
| `ripgrep` | `pkgs` | Primary file search tool used by Claude Code |
|
||||
| `fd` | `pkgs` | Fast `find` replacement used by Claude Code |
|
||||
| `gh` | `pkgs` | GitHub CLI for PR/issue operations |
|
||||
| `jq` | `pkgs` | JSON processing in shell pipelines |
|
||||
|
||||
`git`, `nodejs`, and `docker` are already provided by existing modules and are not duplicated.
|
||||
|
||||
**Contingency:** If `pkgs.unstable.claude-code` does not exist at eval time, the fallback is a custom derivation in `pkgs/claude-code/default.nix` added to the local overlay — the same mechanism used for other absent packages.
|
||||
|
||||
## No Secrets Management
|
||||
|
||||
The Anthropic API key is handled manually by the user (browser login / `claude` interactive setup). No sops-nix or shell-profile injection needed.
|
||||
|
||||
## Future: Headless Service
|
||||
|
||||
A commented block in the module documents the upgrade path: a systemd user service that accepts work via an HTTP API or Unix socket, triggerable over SSH or a local network endpoint, without requiring an interactive session.
|
||||
|
||||
## Files Changed
|
||||
|
||||
1. `modules/environments/claude-code/default.nix` — new profile module
|
||||
2. `modules/environments/default.nix` — add `./claude-code` import
|
||||
3. `machines/mibook/environments.nix` — set `my.profiles.claude-code.enable = true`
|
||||
Generated
+278
@@ -0,0 +1,278 @@
|
||||
{
|
||||
"nodes": {
|
||||
"flake-compat": {
|
||||
"flake": false,
|
||||
"locked": {
|
||||
"lastModified": 1767039857,
|
||||
"narHash": "sha256-vNpUSpF5Nuw8xvDLj2KCwwksIbjua2LZCqhV1LNRDns=",
|
||||
"owner": "NixOS",
|
||||
"repo": "flake-compat",
|
||||
"rev": "5edf11c44bc78a0d334f6334cdaf7d60d732daab",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "NixOS",
|
||||
"repo": "flake-compat",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"flake-parts": {
|
||||
"inputs": {
|
||||
"nixpkgs-lib": "nixpkgs-lib"
|
||||
},
|
||||
"locked": {
|
||||
"lastModified": 1778716662,
|
||||
"narHash": "sha256-m1Yf0wZ8j1OHjTc2UwHwyQRSnNeSgLJOd7q5Y45hzi4=",
|
||||
"owner": "hercules-ci",
|
||||
"repo": "flake-parts",
|
||||
"rev": "f7c1a2d347e4c52d5fb8d10cb4d94b5884e546fb",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "hercules-ci",
|
||||
"repo": "flake-parts",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"flake-parts_2": {
|
||||
"inputs": {
|
||||
"nixpkgs-lib": [
|
||||
"nix",
|
||||
"nixpkgs"
|
||||
]
|
||||
},
|
||||
"locked": {
|
||||
"lastModified": 1778716662,
|
||||
"narHash": "sha256-m1Yf0wZ8j1OHjTc2UwHwyQRSnNeSgLJOd7q5Y45hzi4=",
|
||||
"owner": "hercules-ci",
|
||||
"repo": "flake-parts",
|
||||
"rev": "f7c1a2d347e4c52d5fb8d10cb4d94b5884e546fb",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "hercules-ci",
|
||||
"repo": "flake-parts",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"git-hooks-nix": {
|
||||
"inputs": {
|
||||
"flake-compat": [
|
||||
"nix"
|
||||
],
|
||||
"gitignore": [
|
||||
"nix"
|
||||
],
|
||||
"nixpkgs": [
|
||||
"nix",
|
||||
"nixpkgs"
|
||||
]
|
||||
},
|
||||
"locked": {
|
||||
"lastModified": 1781733627,
|
||||
"narHash": "sha256-U3yTuGBnmXvXoQI3qkpfEDsn9RovQPAjN7ndRco+3u0=",
|
||||
"owner": "cachix",
|
||||
"repo": "git-hooks.nix",
|
||||
"rev": "3bbec39bc90eadfa031e6f3b77272f3f60803e39",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "cachix",
|
||||
"repo": "git-hooks.nix",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"nix": {
|
||||
"inputs": {
|
||||
"flake-compat": "flake-compat",
|
||||
"flake-parts": "flake-parts_2",
|
||||
"git-hooks-nix": "git-hooks-nix",
|
||||
"nixpkgs": "nixpkgs",
|
||||
"nixpkgs-23-11": "nixpkgs-23-11",
|
||||
"nixpkgs-regression": "nixpkgs-regression"
|
||||
},
|
||||
"locked": {
|
||||
"lastModified": 1782211048,
|
||||
"narHash": "sha256-WKITtytZtfU6m24eK/WVI0QHZpHv4VtTpDCR3414Q70=",
|
||||
"owner": "NixOS",
|
||||
"repo": "nix",
|
||||
"rev": "cdf3b417b272ce2c1de41445378c17f4bebf6fb6",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "NixOS",
|
||||
"repo": "nix",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"nixlib": {
|
||||
"locked": {
|
||||
"lastModified": 1736643958,
|
||||
"narHash": "sha256-tmpqTSWVRJVhpvfSN9KXBvKEXplrwKnSZNAoNPf/S/s=",
|
||||
"owner": "nix-community",
|
||||
"repo": "nixpkgs.lib",
|
||||
"rev": "1418bc28a52126761c02dd3d89b2d8ca0f521181",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "nix-community",
|
||||
"repo": "nixpkgs.lib",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"nixos-generators": {
|
||||
"inputs": {
|
||||
"nixlib": "nixlib",
|
||||
"nixpkgs": [
|
||||
"nixpkgs"
|
||||
]
|
||||
},
|
||||
"locked": {
|
||||
"lastModified": 1769813415,
|
||||
"narHash": "sha256-nnVmNNKBi1YiBNPhKclNYDORoHkuKipoz7EtVnXO50A=",
|
||||
"owner": "nix-community",
|
||||
"repo": "nixos-generators",
|
||||
"rev": "8946737ff703382fda7623b9fab071d037e897d5",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "nix-community",
|
||||
"repo": "nixos-generators",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"nixos-hardware": {
|
||||
"inputs": {
|
||||
"nixpkgs": "nixpkgs_2"
|
||||
},
|
||||
"locked": {
|
||||
"lastModified": 1782166108,
|
||||
"narHash": "sha256-/EtnQBcKbsaCAGQ5VRcplrHRkR4ryqyLMpBfkVuG9Xw=",
|
||||
"owner": "NixOS",
|
||||
"repo": "nixos-hardware",
|
||||
"rev": "875776f0252fcb8618bb948640a0d1f7a5b362be",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "NixOS",
|
||||
"repo": "nixos-hardware",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"nixpkgs": {
|
||||
"locked": {
|
||||
"lastModified": 1780902259,
|
||||
"narHash": "sha256-YMnBf9lk/LYgvqfmSSJuOGigtRs5Lsy26pJHVlR9yMY=",
|
||||
"rev": "bd0ff2d3eac24699c3664d5966b9ef36f388e2ca",
|
||||
"type": "tarball",
|
||||
"url": "https://releases.nixos.org/nixos/26.05/nixos-26.05.1550.bd0ff2d3eac2/nixexprs.tar.xz"
|
||||
},
|
||||
"original": {
|
||||
"type": "tarball",
|
||||
"url": "https://channels.nixos.org/nixos-26.05/nixexprs.tar.xz"
|
||||
}
|
||||
},
|
||||
"nixpkgs-23-11": {
|
||||
"locked": {
|
||||
"lastModified": 1717159533,
|
||||
"narHash": "sha256-oamiKNfr2MS6yH64rUn99mIZjc45nGJlj9eGth/3Xuw=",
|
||||
"owner": "NixOS",
|
||||
"repo": "nixpkgs",
|
||||
"rev": "a62e6edd6d5e1fa0329b8653c801147986f8d446",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "NixOS",
|
||||
"repo": "nixpkgs",
|
||||
"rev": "a62e6edd6d5e1fa0329b8653c801147986f8d446",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"nixpkgs-lib": {
|
||||
"locked": {
|
||||
"lastModified": 1777168982,
|
||||
"narHash": "sha256-GOkGPcboWE9BmGCRMLX3worL4EMnsnG8MyKmXNeYuhQ=",
|
||||
"owner": "nix-community",
|
||||
"repo": "nixpkgs.lib",
|
||||
"rev": "f5901329dade4a6ea039af1433fb087bd9c1fe14",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "nix-community",
|
||||
"repo": "nixpkgs.lib",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"nixpkgs-regression": {
|
||||
"locked": {
|
||||
"lastModified": 1643052045,
|
||||
"narHash": "sha256-uGJ0VXIhWKGXxkeNnq4TvV3CIOkUJ3PAoLZ3HMzNVMw=",
|
||||
"owner": "NixOS",
|
||||
"repo": "nixpkgs",
|
||||
"rev": "215d4d0fd80ca5163643b03a33fde804a29cc1e2",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"owner": "NixOS",
|
||||
"repo": "nixpkgs",
|
||||
"rev": "215d4d0fd80ca5163643b03a33fde804a29cc1e2",
|
||||
"type": "github"
|
||||
}
|
||||
},
|
||||
"nixpkgs-unstable": {
|
||||
"locked": {
|
||||
"lastModified": 1781577229,
|
||||
"narHash": "sha256-lrp67w8AulE9Ks53n27I45ADSzbOCn4H+CNW1Ck8B+8=",
|
||||
"owner": "NixOS",
|
||||
"repo": "nixpkgs",
|
||||
"rev": "567a49d1913ce81ac6e9582e3553dd90a955875f",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"id": "nixpkgs",
|
||||
"ref": "nixos-unstable",
|
||||
"type": "indirect"
|
||||
}
|
||||
},
|
||||
"nixpkgs_2": {
|
||||
"locked": {
|
||||
"lastModified": 1767892417,
|
||||
"narHash": "sha256-8bW3q88CEg2u4hSP66Vf4lpbLonHz7hqDNBMcCY7E9U=",
|
||||
"rev": "3497aa5c9457a9d88d71fa93a4a8368816fbeeba",
|
||||
"type": "tarball",
|
||||
"url": "https://releases.nixos.org/nixos/unstable/nixos-26.05pre924538.3497aa5c9457/nixexprs.tar.xz"
|
||||
},
|
||||
"original": {
|
||||
"type": "tarball",
|
||||
"url": "https://channels.nixos.org/nixos-unstable/nixexprs.tar.xz"
|
||||
}
|
||||
},
|
||||
"nixpkgs_3": {
|
||||
"locked": {
|
||||
"lastModified": 1782116945,
|
||||
"narHash": "sha256-G3tw/IXmaH6IQ2upZvhuN9sG8CkuX+BLuJDpE8hz0Ds=",
|
||||
"owner": "NixOS",
|
||||
"repo": "nixpkgs",
|
||||
"rev": "34268251cf5547d39063f2c5ea9a196246f7f3a6",
|
||||
"type": "github"
|
||||
},
|
||||
"original": {
|
||||
"id": "nixpkgs",
|
||||
"ref": "nixos-26.05",
|
||||
"type": "indirect"
|
||||
}
|
||||
},
|
||||
"root": {
|
||||
"inputs": {
|
||||
"flake-parts": "flake-parts",
|
||||
"nix": "nix",
|
||||
"nixos-generators": "nixos-generators",
|
||||
"nixos-hardware": "nixos-hardware",
|
||||
"nixpkgs": "nixpkgs_3",
|
||||
"nixpkgs-unstable": "nixpkgs-unstable"
|
||||
}
|
||||
}
|
||||
},
|
||||
"root": "root",
|
||||
"version": 7
|
||||
}
|
||||
@@ -0,0 +1,43 @@
|
||||
{
|
||||
description = "NixOS configuration";
|
||||
|
||||
inputs = {
|
||||
nix.url = "github:NixOS/nix";
|
||||
nixpkgs.url = "nixpkgs/nixos-26.05";
|
||||
nixpkgs-unstable.url = "nixpkgs/nixos-unstable";
|
||||
flake-parts.url = "github:hercules-ci/flake-parts";
|
||||
nixos-hardware.url = "github:NixOS/nixos-hardware";
|
||||
nixos-generators = {
|
||||
url = "github:nix-community/nixos-generators";
|
||||
inputs.nixpkgs.follows = "nixpkgs";
|
||||
};
|
||||
|
||||
};
|
||||
|
||||
outputs =
|
||||
inputs@{ self, flake-parts, ... }:
|
||||
flake-parts.lib.mkFlake { inherit inputs; } {
|
||||
|
||||
imports = [
|
||||
./machines/configuration.nix
|
||||
];
|
||||
|
||||
perSystem =
|
||||
{
|
||||
self',
|
||||
inputs',
|
||||
config,
|
||||
pkgs,
|
||||
system,
|
||||
...
|
||||
}:
|
||||
{
|
||||
# make pkgs available to all `perSystem` functions
|
||||
_module.args.pkgs = import inputs.nixpkgs {
|
||||
inherit system;
|
||||
};
|
||||
};
|
||||
|
||||
systems = [ "x86_64-linux" ];
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,67 @@
|
||||
{ self, ... }:
|
||||
let
|
||||
inherit (self.inputs)
|
||||
nixpkgs
|
||||
nixpkgs-unstable
|
||||
nixos-hardware
|
||||
#hyprland
|
||||
;
|
||||
nixosSystem = nixpkgs.lib.makeOverridable nixpkgs.lib.nixosSystem;
|
||||
overlay-unstable = final: prev: {
|
||||
unstable = import nixpkgs-unstable {
|
||||
inherit (final) system;
|
||||
config.allowUnfree = true;
|
||||
};
|
||||
};
|
||||
|
||||
customModules = import ./core/default.nix;
|
||||
baseModules = [
|
||||
# make flake inputs accessible in NixOS
|
||||
{
|
||||
_module.args.self = self;
|
||||
_module.args.inputs = self.inputs;
|
||||
}
|
||||
{
|
||||
imports = [
|
||||
(
|
||||
{ pkgs, ... }:
|
||||
{
|
||||
nixpkgs.overlays = [
|
||||
overlay-unstable
|
||||
(import ../pkgs)
|
||||
];
|
||||
nix.nixPath = [
|
||||
"nixpkgs=${pkgs.path}"
|
||||
];
|
||||
documentation.info.enable = false;
|
||||
}
|
||||
)
|
||||
#hyprland.nixosModules.default
|
||||
];
|
||||
}
|
||||
../modules
|
||||
# ../profiles
|
||||
];
|
||||
defaultModules = baseModules ++ customModules;
|
||||
in
|
||||
{
|
||||
flake.nixosConfigurations = {
|
||||
# use your hardware- model from this list: https://github.com/NixOS/nixos-hardware/blob/master/flake.nix
|
||||
jupiter = nixosSystem {
|
||||
system = "x86_64-linux";
|
||||
specialArgs = { inherit self; };
|
||||
modules = defaultModules ++ [
|
||||
# nixos-hardware.nixosModules.bmax-b7-power
|
||||
./jupiter/configuration.nix
|
||||
];
|
||||
};
|
||||
mibook = nixosSystem {
|
||||
system = "x86_64-linux";
|
||||
specialArgs = { inherit self; };
|
||||
modules = defaultModules ++ [
|
||||
# nixos-hardware.nixosModules.mibook
|
||||
./mibook/configuration.nix
|
||||
];
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,158 @@
|
||||
# Edit this configuration file to define what should be installed on
|
||||
# your system. Help is available in the configuration.nix(5) man page
|
||||
# and in the NixOS manual (accessible by running ‘nixos-help’).
|
||||
|
||||
{ config, pkgs, ... }:
|
||||
|
||||
{
|
||||
imports = [
|
||||
# Include the results of the hardware scan.
|
||||
./hardware-configuration.nix
|
||||
];
|
||||
|
||||
# Bootloader.
|
||||
boot.loader.grub.enable = true;
|
||||
boot.loader.grub.device = "/dev/sda";
|
||||
boot.loader.grub.useOSProber = true;
|
||||
|
||||
networking.hostName = "nixos"; # Define your hostname.
|
||||
# networking.wireless.enable = true; # Enables wireless support via wpa_supplicant.
|
||||
|
||||
# Configure network proxy if necessary
|
||||
# networking.proxy.default = "http://user:password@proxy:port/";
|
||||
# networking.proxy.noProxy = "127.0.0.1,localhost,internal.domain";
|
||||
|
||||
# Enable networking
|
||||
networking.networkmanager.enable = true;
|
||||
|
||||
# Set your time zone.
|
||||
time.timeZone = "Europe/Berlin";
|
||||
|
||||
# Select internationalisation properties.
|
||||
i18n.defaultLocale = "en_US.UTF-8";
|
||||
|
||||
i18n.extraLocaleSettings = {
|
||||
LC_ADDRESS = "de_DE.UTF-8";
|
||||
LC_IDENTIFICATION = "de_DE.UTF-8";
|
||||
LC_MEASUREMENT = "de_DE.UTF-8";
|
||||
LC_MONETARY = "de_DE.UTF-8";
|
||||
LC_NAME = "de_DE.UTF-8";
|
||||
LC_NUMERIC = "de_DE.UTF-8";
|
||||
LC_PAPER = "de_DE.UTF-8";
|
||||
LC_TELEPHONE = "de_DE.UTF-8";
|
||||
LC_TIME = "de_DE.UTF-8";
|
||||
};
|
||||
|
||||
# Enable the X11 windowing system.
|
||||
services.xserver.enable = true;
|
||||
|
||||
# Enable the GNOME Desktop Environment.
|
||||
services.xserver.displayManager.gdm.enable = true;
|
||||
services.xserver.desktopManager.gnome.enable = true;
|
||||
|
||||
# Configure keymap in X11
|
||||
services.xserver = {
|
||||
layout = "de";
|
||||
xkbVariant = "";
|
||||
};
|
||||
|
||||
# Configure console keymap
|
||||
console.keyMap = "de";
|
||||
|
||||
# Enable CUPS to print documents.
|
||||
services.printing.enable = true;
|
||||
|
||||
# Enable sound with pipewire.
|
||||
hardware.pulseaudio.enable = false;
|
||||
security.rtkit.enable = true;
|
||||
services.pipewire = {
|
||||
enable = true;
|
||||
alsa.enable = true;
|
||||
alsa.support32Bit = true;
|
||||
pulse.enable = true;
|
||||
# If you want to use JACK applications, uncomment this
|
||||
#jack.enable = true;
|
||||
|
||||
# use the example session manager (no others are packaged yet so this is enabled by default,
|
||||
# no need to redefine it in your config for now)
|
||||
#media-session.enable = true;
|
||||
};
|
||||
|
||||
# Enable touchpad support (enabled default in most desktopManager).
|
||||
# services.xserver.libinput.enable = true;
|
||||
|
||||
# Define a user account. Don't forget to set a password with ‘passwd’.
|
||||
users.users.finn = {
|
||||
isNormalUser = true;
|
||||
description = "Finn Markwitz";
|
||||
extraGroups = [
|
||||
"networkmanager"
|
||||
"wheel"
|
||||
];
|
||||
packages = with pkgs; [
|
||||
firefox
|
||||
jetbrains.webstorm
|
||||
jetbrains.goland
|
||||
jetbrains.pycharm-professional
|
||||
jetbrains.idea-ultimate
|
||||
thunderbird
|
||||
google-chrome
|
||||
discord
|
||||
spotify
|
||||
keepassxc
|
||||
nextcloud-client
|
||||
zsh
|
||||
oh-my-zsh
|
||||
neovim
|
||||
];
|
||||
};
|
||||
|
||||
# Enable automatic login for the user.
|
||||
services.xserver.displayManager.autoLogin.enable = true;
|
||||
services.xserver.displayManager.autoLogin.user = "finn";
|
||||
|
||||
# Workaround for GNOME autologin: https://github.com/NixOS/nixpkgs/issues/103746#issuecomment-945091229
|
||||
systemd.services."getty@tty1".enable = false;
|
||||
systemd.services."autovt@tty1".enable = false;
|
||||
|
||||
# Allow unfree packages
|
||||
nixpkgs.config.allowUnfree = true;
|
||||
|
||||
# List packages installed in system profile. To search, run:
|
||||
# $ nix search wget
|
||||
environment.systemPackages = with pkgs; [
|
||||
vim # Do not forget to add an editor to edit configuration.nix! The Nano editor is also installed by default.
|
||||
wget
|
||||
git
|
||||
python312
|
||||
nodejs_18
|
||||
];
|
||||
|
||||
# Some programs need SUID wrappers, can be configured further or are
|
||||
# started in user sessions.
|
||||
# programs.mtr.enable = true;
|
||||
# programs.gnupg.agent = {
|
||||
# enable = true;
|
||||
# enableSSHSupport = true;
|
||||
# };
|
||||
|
||||
# List services that you want to enable:
|
||||
|
||||
# Enable the OpenSSH daemon.
|
||||
# services.openssh.enable = true;
|
||||
|
||||
# Open ports in the firewall.
|
||||
# networking.firewall.allowedTCPPorts = [ ... ];
|
||||
# networking.firewall.allowedUDPPorts = [ ... ];
|
||||
# Or disable the firewall altogether.
|
||||
# networking.firewall.enable = false;
|
||||
|
||||
# This value determines the NixOS release from which the default
|
||||
# settings for stateful data, like file locations and database versions
|
||||
# on your system were taken. It‘s perfectly fine and recommended to leave
|
||||
# this value at the release version of the first install of this system.
|
||||
# Before changing this value read the documentation for this option
|
||||
# (e.g. man configuration.nix or on https://nixos.org/nixos/options.html).
|
||||
system.stateVersion = "23.05"; # Did you read the comment?
|
||||
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
{
|
||||
config,
|
||||
pkgs,
|
||||
lib,
|
||||
...
|
||||
}:
|
||||
{
|
||||
# Packages
|
||||
environment.systemPackages = with pkgs; [
|
||||
bandwhich
|
||||
bind # dig
|
||||
borgbackup
|
||||
cryptsetup
|
||||
file
|
||||
fwupd
|
||||
fzf
|
||||
gettext
|
||||
git
|
||||
gptfdisk
|
||||
htop
|
||||
jq
|
||||
killall
|
||||
lsof
|
||||
mosh
|
||||
multipath-tools # kpartx
|
||||
mtr
|
||||
nmap
|
||||
nmon
|
||||
ouch # de-/compress
|
||||
pciutils
|
||||
progress
|
||||
pv
|
||||
reptyr
|
||||
rsync
|
||||
screen
|
||||
stress-ng
|
||||
usbutils
|
||||
tmux
|
||||
vim
|
||||
wget
|
||||
whois
|
||||
zip
|
||||
unzip
|
||||
networkmanager
|
||||
lm_sensors
|
||||
systemctl-tui
|
||||
nixfmt-rfc-style
|
||||
];
|
||||
|
||||
time.timeZone = "Europe/Berlin";
|
||||
services.timesyncd.enable = true;
|
||||
|
||||
# Enable networking
|
||||
networking.networkmanager.enable = true;
|
||||
|
||||
# Select internationalisation properties.
|
||||
i18n.defaultLocale = "en_US.UTF-8";
|
||||
|
||||
i18n.extraLocaleSettings = {
|
||||
LC_ADDRESS = "de_DE.UTF-8";
|
||||
LC_IDENTIFICATION = "de_DE.UTF-8";
|
||||
LC_MEASUREMENT = "de_DE.UTF-8";
|
||||
LC_MONETARY = "de_DE.UTF-8";
|
||||
LC_NAME = "de_DE.UTF-8";
|
||||
LC_NUMERIC = "de_DE.UTF-8";
|
||||
LC_PAPER = "de_DE.UTF-8";
|
||||
LC_TELEPHONE = "de_DE.UTF-8";
|
||||
LC_TIME = "de_DE.UTF-8";
|
||||
};
|
||||
|
||||
}
|
||||
@@ -0,0 +1,7 @@
|
||||
[
|
||||
./core.nix
|
||||
./modules.nix
|
||||
./network.nix
|
||||
./nix.nix
|
||||
./users.nix
|
||||
]
|
||||
@@ -0,0 +1,8 @@
|
||||
# Generate via nix-generate
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
{ }
|
||||
@@ -0,0 +1,20 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
|
||||
{
|
||||
networking.networkmanager = {
|
||||
enable = true;
|
||||
|
||||
unmanaged = [
|
||||
"interface-name:br-*" # Ignore docker compose network bridges
|
||||
"interface-name:docker?" # Ignore docker default bridge
|
||||
"interface-name:veth*" # Ignore docker compose network devices
|
||||
"interface-name:virbr?" # Ignore libvirt default bridge
|
||||
];
|
||||
};
|
||||
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
inputs,
|
||||
...
|
||||
}:
|
||||
{
|
||||
nix = {
|
||||
daemonCPUSchedPolicy = "idle";
|
||||
daemonIOSchedClass = "idle";
|
||||
|
||||
settings = {
|
||||
auto-optimise-store = true;
|
||||
};
|
||||
|
||||
gc = {
|
||||
automatic = true;
|
||||
options = "--delete-older-than 30d";
|
||||
};
|
||||
|
||||
extraOptions = ''
|
||||
experimental-features = nix-command flakes
|
||||
warn-dirty = false
|
||||
'';
|
||||
|
||||
registry = {
|
||||
nixpkgs.flake = inputs.nixpkgs;
|
||||
unstable.flake = inputs.nixpkgs-unstable;
|
||||
};
|
||||
};
|
||||
nixpkgs.config.allowUnfree = true;
|
||||
}
|
||||
@@ -0,0 +1,32 @@
|
||||
{
|
||||
config,
|
||||
pkgs,
|
||||
lib,
|
||||
...
|
||||
}:
|
||||
{
|
||||
|
||||
users.users.finn = {
|
||||
isNormalUser = true;
|
||||
home = "/home/finn";
|
||||
group = "finn";
|
||||
extraGroups = [
|
||||
"adbusers" # adb control
|
||||
"audio" # sound control
|
||||
"dialout" # serial-console
|
||||
"docker" # usage of `docker` socket
|
||||
"input" # mouse control
|
||||
"libvirtd" # kvm control
|
||||
"networkmanager" # wireless configuration
|
||||
"podman" # usage of `podman` socket
|
||||
"video" # screen control
|
||||
"wheel" # `sudo` for the user.
|
||||
];
|
||||
|
||||
# openssh.authorizedKeys.keys = [ "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOFx6OLwL9MbkD3mnMsv+xrzZHN/rwCTgVs758SCLG0h finn@thinkman" ];
|
||||
};
|
||||
|
||||
users.groups.finn = {
|
||||
gid = 1000;
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,66 @@
|
||||
{
|
||||
config,
|
||||
pkgs,
|
||||
lib,
|
||||
...
|
||||
}:
|
||||
{
|
||||
imports = [
|
||||
|
||||
./disks.nix
|
||||
./hardware-configuration.nix
|
||||
./environments.nix
|
||||
# ./network.nix
|
||||
];
|
||||
|
||||
networking.hostName = "jupiter";
|
||||
|
||||
boot.loader.systemd-boot.enable = true;
|
||||
boot.loader.efi.canTouchEfiVariables = true;
|
||||
boot.kernelPackages = pkgs.linuxPackages;
|
||||
|
||||
# Shitfuck SOnar Dotnet dependency
|
||||
nixpkgs.config = {
|
||||
permittedInsecurePackages = [
|
||||
"aspnetcore-runtime-6.0.36"
|
||||
"aspnetcore-runtime-wrapped-6.0.36"
|
||||
"dotnet-sdk-6.0.428"
|
||||
"dotnet-sdk-wrapped-6.0.428"
|
||||
];
|
||||
};
|
||||
|
||||
services.openssh.enable = true;
|
||||
|
||||
# Configure keymap in X11
|
||||
services.xserver.xkb = {
|
||||
layout = "de";
|
||||
variant = "";
|
||||
};
|
||||
|
||||
# Configure console keymap
|
||||
console.keyMap = "de";
|
||||
|
||||
# Enable CUPS to print documents.
|
||||
services.printing.enable = true;
|
||||
services.fwupd.enable = true;
|
||||
|
||||
security.rtkit.enable = true;
|
||||
|
||||
# Try fix wifi disconnect
|
||||
networking.networkmanager.wifi.powersave = false;
|
||||
|
||||
# Disable hibernate completely
|
||||
powerManagement.enable = true;
|
||||
systemd.targets."hibernate".enable = false;
|
||||
systemd.targets."hybrid-sleep".enable = false;
|
||||
systemd.targets."suspend-then-hibernate".enable = false;
|
||||
|
||||
# Optional: kernel parameter to fully disable hibernation
|
||||
boot.kernelParams = [ "nohibernate" ];
|
||||
|
||||
|
||||
system = {
|
||||
stateVersion = "23.05";
|
||||
autoUpgrade.enable = true;
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,30 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
|
||||
#TODO: CHECK THIS OUT: https://github.com/nix-community/disko its kinda better but felix does not support it
|
||||
|
||||
{
|
||||
fileSystems."/" =
|
||||
{ device = "/dev/disk/by-uuid/8e3ac6ce-6865-49d8-b6d0-d7c008de391e";
|
||||
fsType = "ext4";
|
||||
};
|
||||
|
||||
fileSystems."/boot" =
|
||||
{ device = "/dev/disk/by-uuid/F193-2A35";
|
||||
fsType = "vfat";
|
||||
};
|
||||
|
||||
fileSystems."/data/nfs" = {
|
||||
device = "voyager:/";
|
||||
fsType = "nfs";
|
||||
options = [
|
||||
"x-systemd.automount"
|
||||
"noauto"
|
||||
];
|
||||
};
|
||||
|
||||
}
|
||||
@@ -0,0 +1,75 @@
|
||||
# enabled profiles
|
||||
{ config, lib, ... }:
|
||||
let
|
||||
secrets = config.sops.secrets;
|
||||
in
|
||||
{
|
||||
my.profiles = {
|
||||
hyprland.enable = false;
|
||||
zsh.enable = true;
|
||||
apps = {
|
||||
desktop_apps = false;
|
||||
dev_apps = false;
|
||||
gnome_apps = false;
|
||||
};
|
||||
actual.enable = false;
|
||||
audiobookshelf.enable = true;
|
||||
kde-desktop.enable = false;
|
||||
radarr.enable = true;
|
||||
docker.enable = true;
|
||||
readarr.enable = true;
|
||||
sonarr.enable = true;
|
||||
jellyfin.enable = true;
|
||||
jellyseerr.enable = true;
|
||||
development.enable = true;
|
||||
home-assistant.enable = true;
|
||||
|
||||
homepage.enable = true;
|
||||
paperless = {
|
||||
enable = true;
|
||||
port = 28981; # Optional, to override the default port
|
||||
extraConfig = {
|
||||
PAPERLESS_ADMIN_USER = "finn";
|
||||
PAPERLESS_OCR_LANGUAGE = "deu+eng";
|
||||
};
|
||||
};
|
||||
prowlarr.enable = true;
|
||||
};
|
||||
|
||||
# my.homepage.widgets = [
|
||||
# {
|
||||
# search = {
|
||||
# provider = "google";
|
||||
# target = "_blank";
|
||||
# };
|
||||
# }
|
||||
# {
|
||||
# resources = {
|
||||
# cpu = true;
|
||||
# memory = true;
|
||||
# disk = "/";
|
||||
# cacheInterval = 5000;
|
||||
# };
|
||||
# }
|
||||
# {
|
||||
# datetime = {
|
||||
# text_size = "xl";
|
||||
# format = {
|
||||
# timeStyle = "short";
|
||||
# dateStyle = "short";
|
||||
# hour12 = false;
|
||||
# };
|
||||
# };
|
||||
# }
|
||||
# ];
|
||||
|
||||
my.hardware = {
|
||||
bluetooth.enable = true;
|
||||
sound.enable = false;
|
||||
};
|
||||
|
||||
my.services = {
|
||||
vpn.enable = true;
|
||||
webserver.enable = false;
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,69 @@
|
||||
# Do not modify this file! It was generated by ‘nixos-generate-config’
|
||||
# and may be overwritten by future invocations. Please make changes
|
||||
# to /etc/nixos/configuration.nix instead.
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
modulesPath,
|
||||
...
|
||||
}:
|
||||
|
||||
{
|
||||
imports = [
|
||||
(modulesPath + "/installer/scan/not-detected.nix")
|
||||
];
|
||||
|
||||
boot.initrd.availableKernelModules = [
|
||||
"xhci_pci"
|
||||
"ahci"
|
||||
"nvme"
|
||||
];
|
||||
boot.initrd.kernelModules = [ ];
|
||||
boot.kernelModules = [ "kvm-intel" ];
|
||||
boot.extraModulePackages = [ ];
|
||||
#boot.kernelParams = [ "i915.force_probe=9a49" ];
|
||||
# 9a49
|
||||
|
||||
nixpkgs.config.packageOverrides = pkgs: {
|
||||
vaapiIntel = pkgs.vaapiIntel.override { enableHybridCodec = true; };
|
||||
};
|
||||
hardware.graphics = {
|
||||
enable = true;
|
||||
extraPackages = with pkgs; [
|
||||
intel-media-driver # LIBVA_DRIVER_NAME=iHD
|
||||
#vaapiIntel # LIBVA_DRIVER_NAME=i965 (older but works better for Firefox/Chromium)
|
||||
libva-vdpau-driver
|
||||
libvdpau-va-gl
|
||||
];
|
||||
};
|
||||
|
||||
hardware.logitech.wireless = {
|
||||
enable = true;
|
||||
enableGraphical = true;
|
||||
};
|
||||
|
||||
fileSystems."/" =
|
||||
{ device = "/dev/disk/by-uuid/8e3ac6ce-6865-49d8-b6d0-d7c008de391e";
|
||||
fsType = "ext4";
|
||||
};
|
||||
|
||||
fileSystems."/boot" =
|
||||
{ device = "/dev/disk/by-uuid/F193-2A35";
|
||||
fsType = "vfat";
|
||||
options = [ "fmask=0077" "dmask=0077" ];
|
||||
};
|
||||
|
||||
swapDevices = [ { device = "/dev/disk/by-uuid/7ffb2d2b-c03d-474b-8513-fee26e1e5e2f"; } ];
|
||||
|
||||
# Enables DHCP on each ethernet and wireless interface. In case of scripted networking
|
||||
# (the default) this is the recommended approach. When using systemd-networkd it's
|
||||
# still possible to use this option, but it's recommended to use it in conjunction
|
||||
# with explicit per-interface declarations with `networking.interfaces.<interface>.useDHCP`.
|
||||
networking.useDHCP = lib.mkDefault true;
|
||||
# networking.interfaces.enp3s0.useDHCP = lib.mkDefault true;
|
||||
|
||||
nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
|
||||
powerManagement.cpuFreqGovernor = lib.mkDefault "performance";
|
||||
hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
|
||||
}
|
||||
@@ -0,0 +1,10 @@
|
||||
_: {
|
||||
networking.firewall.allowedTCPPorts = [
|
||||
8080 # aria
|
||||
];
|
||||
|
||||
networking = {
|
||||
domain = "jupiter.solar.internal";
|
||||
search = [ "jupiter.solar.internal" ];
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,51 @@
|
||||
{
|
||||
config,
|
||||
pkgs,
|
||||
lib,
|
||||
...
|
||||
}:
|
||||
{
|
||||
imports = [
|
||||
|
||||
./disks.nix
|
||||
./hardware-configuration.nix
|
||||
./environments.nix
|
||||
# ./system.nix use docker here
|
||||
];
|
||||
|
||||
networking.hostName = "mibook";
|
||||
boot.loader.grub = {
|
||||
enable = true;
|
||||
device = "/dev/nvme0n1";
|
||||
useOSProber = true;
|
||||
};
|
||||
|
||||
|
||||
# Configure keymap in X11
|
||||
services.xserver.xkb = {
|
||||
layout = "de";
|
||||
variant = "";
|
||||
};
|
||||
|
||||
# Configure console keymap
|
||||
console.keyMap = "de";
|
||||
|
||||
# Enable CUPS to print documents.
|
||||
services.printing.enable = true;
|
||||
nixpkgs.config.allowUnfree = true;
|
||||
|
||||
|
||||
hardware.nvidia.prime = {
|
||||
sync.enable = false;
|
||||
|
||||
nvidiaBusId = "PCI:01:00:0";
|
||||
intelBusId = "PCI:00:2:0";
|
||||
};
|
||||
|
||||
services.openssh.enable = true;
|
||||
|
||||
system = {
|
||||
stateVersion = "23.05";
|
||||
autoUpgrade.enable = true;
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,15 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
|
||||
#TODO: CHECK THIS OUT: https://github.com/nix-community/disko its kinda better but felix does not support it
|
||||
|
||||
{
|
||||
fileSystems."/" = {
|
||||
device = "/dev/disk/by-uuid/46e36a07-e75a-480a-a2f1-be103c6a3881";
|
||||
fsType = "ext4";
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,28 @@
|
||||
# enabled profiles
|
||||
{ config, lib, ... }:
|
||||
let
|
||||
secrets = config.sops.secrets;
|
||||
in
|
||||
{
|
||||
my.profiles = {
|
||||
kde-desktop.enable = true;
|
||||
zsh.enable = true;
|
||||
apps = {
|
||||
desktop_apps = true;
|
||||
dev_apps = true;
|
||||
};
|
||||
development.enable = true;
|
||||
docker.enable = true;
|
||||
claude-code.enable = true;
|
||||
};
|
||||
|
||||
my.hardware = {
|
||||
bluetooth.enable = true;
|
||||
sound.enable = false;
|
||||
nvidia.enable = false;
|
||||
};
|
||||
my.services = {
|
||||
vpn.enable = true;
|
||||
};
|
||||
|
||||
}
|
||||
@@ -0,0 +1,43 @@
|
||||
# Do not modify this file! It was generated by ‘nixos-generate-config’
|
||||
# and may be overwritten by future invocations. Please make changes
|
||||
# to /etc/nixos/configuration.nix instead.
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
modulesPath,
|
||||
...
|
||||
}:
|
||||
|
||||
{
|
||||
imports = [
|
||||
(modulesPath + "/installer/scan/not-detected.nix")
|
||||
];
|
||||
|
||||
boot.initrd.availableKernelModules = [
|
||||
"xhci_pci"
|
||||
"ahci"
|
||||
"nvme"
|
||||
];
|
||||
boot.initrd.kernelModules = [ ];
|
||||
boot.kernelModules = [ "kvm-intel" ];
|
||||
boot.extraModulePackages = [ ];
|
||||
|
||||
fileSystems."/" = {
|
||||
device = "/dev/disk/by-uuid/46e36a07-e75a-480a-a2f1-be103c6a3881";
|
||||
fsType = "ext4";
|
||||
};
|
||||
|
||||
swapDevices = [ ];
|
||||
|
||||
# Enables DHCP on each ethernet and wireless interface. In case of scripted networking
|
||||
# (the default) this is the recommended approach. When using systemd-networkd it's
|
||||
# still possible to use this option, but it's recommended to use it in conjunction
|
||||
# with explicit per-interface declarations with `networking.interfaces.<interface>.useDHCP`.
|
||||
networking.useDHCP = lib.mkDefault true;
|
||||
# networking.interfaces.wlp2s0.useDHCP = lib.mkDefault true;
|
||||
|
||||
nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
|
||||
powerManagement.cpuFreqGovernor = lib.mkDefault "powersave";
|
||||
hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
{ ... }:
|
||||
{
|
||||
imports = [
|
||||
./environments
|
||||
./hardware
|
||||
./services
|
||||
];
|
||||
}
|
||||
@@ -0,0 +1,47 @@
|
||||
# manages and downloads films
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.actual;
|
||||
hostName = config.networking.hostName;
|
||||
port = 40465;
|
||||
in
|
||||
{
|
||||
options.my.profiles.actual = with lib; {
|
||||
enable = mkEnableOption "Actual budget service";
|
||||
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.actual = {
|
||||
enable = true;
|
||||
openFirewall = true;
|
||||
settings = {
|
||||
port = port;
|
||||
hostname = "0.0.0.0";
|
||||
};
|
||||
};
|
||||
|
||||
environment.systemPackages = with pkgs; [
|
||||
actual-server
|
||||
];
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Finance";
|
||||
name = "Actual";
|
||||
description = "Budgeting";
|
||||
href = "http://${hostName}:${toString port}";
|
||||
icon = "mdi-cash";
|
||||
}
|
||||
];
|
||||
|
||||
systemd.services.actual = {
|
||||
after = [ "network-online.target" ];
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,35 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.apps;
|
||||
in
|
||||
{
|
||||
|
||||
options.my.profiles.apps = with lib; {
|
||||
desktop_apps = mkEnableOption "Basic Apps";
|
||||
dev_apps = mkEnableOption "Development Apps";
|
||||
gnome_apps = mkEnableOption "Gnome Extentions and Configuration";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.desktop_apps {
|
||||
users.users.finn.packages = with pkgs; [
|
||||
firefox
|
||||
thunderbird
|
||||
google-chrome
|
||||
vscode
|
||||
discord
|
||||
spotify
|
||||
keepassxc
|
||||
moonlight-qt
|
||||
nextcloud-client
|
||||
pipewire
|
||||
wireplumber
|
||||
vlc
|
||||
ghostty
|
||||
];
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,44 @@
|
||||
# manages and downloads films
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.audiobookshelf;
|
||||
hostName = config.networking.hostName;
|
||||
in
|
||||
{
|
||||
options.my.profiles.audiobookshelf = with lib; {
|
||||
enable = mkEnableOption "Audio Book Service";
|
||||
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.audiobookshelf = {
|
||||
enable = true;
|
||||
openFirewall = true;
|
||||
port = 63834;
|
||||
host = "0.0.0.0";
|
||||
};
|
||||
|
||||
environment.systemPackages = with pkgs; [
|
||||
audiobookshelf
|
||||
];
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Media";
|
||||
name = "Audiobookshelf";
|
||||
description = "Audiobooks and podcasts";
|
||||
href = "http://${hostName}:63834";
|
||||
icon = "audiobookshelf.png";
|
||||
}
|
||||
];
|
||||
|
||||
systemd.services.audiobookshelf = {
|
||||
after = [ "network-online.target" ];
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,31 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.claude-code;
|
||||
in
|
||||
{
|
||||
options.my.profiles.claude-code = with lib; {
|
||||
enable = mkEnableOption "Claude Code CLI";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
users.users.finn.packages = with pkgs; [
|
||||
claude-code
|
||||
ripgrep
|
||||
fd
|
||||
gh
|
||||
jq
|
||||
];
|
||||
|
||||
# Future: headless Claude Code service
|
||||
# A natural next step is exposing Claude Code as a persistent background service —
|
||||
# e.g. a systemd user service that accepts work via an HTTP API or Unix socket,
|
||||
# triggerable over SSH or a local network endpoint. This would turn the MiBook
|
||||
# into a true remote execution node without requiring an interactive session.
|
||||
# See: my.profiles.claude-code.service.enable (not yet implemented)
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,23 @@
|
||||
{ ... }:
|
||||
{
|
||||
imports = [
|
||||
./actual
|
||||
./apps
|
||||
./audiobookshelf
|
||||
./claude-code
|
||||
./development
|
||||
./home-assistant
|
||||
./hyprland
|
||||
./zsh
|
||||
./paperless
|
||||
./prowlarr
|
||||
./radarr
|
||||
./docker
|
||||
./homepage
|
||||
./kde-desktop
|
||||
./readarr
|
||||
./sonarr
|
||||
./jellyfin
|
||||
./jellyseerr
|
||||
];
|
||||
}
|
||||
@@ -0,0 +1,40 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.development;
|
||||
in
|
||||
{
|
||||
|
||||
options.my.profiles.development = with lib; {
|
||||
enable = mkEnableOption "Development Tools";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
users.users.finn.packages = with pkgs; [
|
||||
google-chrome
|
||||
vscode
|
||||
zed-editor
|
||||
neovim
|
||||
# jetbrains.idea-ultimate
|
||||
go
|
||||
(python3.withPackages (
|
||||
ps: with ps; [
|
||||
jupyter # notebooks
|
||||
matplotlib
|
||||
numpy
|
||||
pandas
|
||||
pillow
|
||||
plotly
|
||||
scikit-learn
|
||||
scipy
|
||||
tqdm # progressbar in pandas
|
||||
wheel # python development
|
||||
]
|
||||
))
|
||||
];
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
# Docker related settings
|
||||
{
|
||||
config,
|
||||
inputs,
|
||||
lib,
|
||||
options,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.docker;
|
||||
in
|
||||
{
|
||||
options.my.profiles.docker = with lib; {
|
||||
enable = mkEnableOption "docker configuration";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
environment.systemPackages = with pkgs; [
|
||||
docker
|
||||
docker-compose
|
||||
];
|
||||
|
||||
virtualisation.docker = {
|
||||
enable = true;
|
||||
autoPrune.enable = true;
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,74 @@
|
||||
# manages home automations
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
self,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.home-assistant;
|
||||
hostName = config.networking.hostName;
|
||||
in
|
||||
{
|
||||
|
||||
options.my.profiles.home-assistant = with lib; {
|
||||
enable = mkEnableOption "Home Automation";
|
||||
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.matter-server.enable = true;
|
||||
|
||||
services.home-assistant = {
|
||||
enable = true;
|
||||
openFirewall = true;
|
||||
extraComponents = [
|
||||
"matter"
|
||||
"mobile_app"
|
||||
"otbr"
|
||||
"thread"
|
||||
"xiaomi_miio"
|
||||
];
|
||||
};
|
||||
services.home-assistant.config = {
|
||||
homeassistant = {
|
||||
name = "Home - Rechberg";
|
||||
unit_system = "metric";
|
||||
internal_url = "http://${hostName}:8123";
|
||||
external_url = "http://jupiter.solar.internal:8123";
|
||||
};
|
||||
mobile_app = {};
|
||||
automation = "!include automations.yaml";
|
||||
script = "!include scripts.yaml";
|
||||
scene = "!include scenes.yaml";
|
||||
};
|
||||
|
||||
# `!include` targets must exist or HA fails at startup. Create them empty
|
||||
# so HA's UI editor can write to them; `f` only acts if the file is absent.
|
||||
systemd.tmpfiles.rules = [
|
||||
"f /var/lib/hass/automations.yaml 0644 hass hass - []"
|
||||
"f /var/lib/hass/scripts.yaml 0644 hass hass - {}"
|
||||
"f /var/lib/hass/scenes.yaml 0644 hass hass - []"
|
||||
];
|
||||
|
||||
services.openthread-border-router = {
|
||||
enable = true;
|
||||
package = pkgs.unstable.openthread-border-router;
|
||||
openFirewall = true;
|
||||
backboneInterfaces = [ "enp3s0" ];
|
||||
radio.device = "/dev/serial/by-id/usb-Nabu_Casa_ZBT-2_DCB4D9149C7C-if00";
|
||||
radio.baudRate = 460800;
|
||||
};
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Services";
|
||||
name = "Home Assistant";
|
||||
description = "Home automation";
|
||||
href = "http://${hostName}:8123";
|
||||
icon = "si-homeassistant";
|
||||
}
|
||||
];
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
[
|
||||
{
|
||||
Developer = [
|
||||
{
|
||||
Github = [
|
||||
{
|
||||
abbr = "GitLab - Smoothcloud";
|
||||
href = "https://gitlab.smoothcloud.de/";
|
||||
}
|
||||
];
|
||||
}
|
||||
];
|
||||
}
|
||||
{
|
||||
Social = [
|
||||
{
|
||||
Reddit = [
|
||||
{
|
||||
icon = "reddit.png";
|
||||
href = "https://reddit.com/";
|
||||
description = "The front page of the internet";
|
||||
}
|
||||
];
|
||||
}
|
||||
];
|
||||
}
|
||||
{
|
||||
Entertainment = [
|
||||
{
|
||||
YouTube = [
|
||||
{
|
||||
abbr = "YT";
|
||||
href = "https://youtube.com/";
|
||||
}
|
||||
];
|
||||
}
|
||||
];
|
||||
}
|
||||
]
|
||||
@@ -0,0 +1,110 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.homepage;
|
||||
dashboardPort = 8082;
|
||||
dashboardHost = config.networking.hostName;
|
||||
dashboardUrl = "http://${dashboardHost}:${toString dashboardPort}";
|
||||
manualServices = import ./manual-services.nix;
|
||||
manualWidgets = import ./manual-widgets.nix;
|
||||
|
||||
groupedServices =
|
||||
lib.foldl'
|
||||
(
|
||||
acc: entry:
|
||||
acc
|
||||
// {
|
||||
${entry.group} = (acc.${entry.group} or [ ]) ++ [ entry ];
|
||||
}
|
||||
)
|
||||
{ }
|
||||
config.my.homepage.services;
|
||||
|
||||
homepageServices = lib.mapAttrsToList (
|
||||
group: entries:
|
||||
{
|
||||
${group} = map (
|
||||
entry:
|
||||
let
|
||||
service = builtins.removeAttrs entry [
|
||||
"group"
|
||||
"name"
|
||||
];
|
||||
in
|
||||
{
|
||||
${entry.name} = lib.filterAttrs (_: value: value != null) service;
|
||||
}
|
||||
) entries;
|
||||
}
|
||||
) groupedServices;
|
||||
in
|
||||
{
|
||||
|
||||
options.my.homepage.services = with lib; mkOption {
|
||||
type = types.listOf (
|
||||
types.submodule {
|
||||
options = {
|
||||
group = mkOption {
|
||||
type = types.str;
|
||||
description = "Homepage service group";
|
||||
};
|
||||
|
||||
name = mkOption {
|
||||
type = types.str;
|
||||
description = "Homepage service name";
|
||||
};
|
||||
|
||||
description = mkOption {
|
||||
type = types.str;
|
||||
description = "Homepage service description";
|
||||
};
|
||||
|
||||
href = mkOption {
|
||||
type = types.str;
|
||||
description = "Homepage service URL";
|
||||
};
|
||||
|
||||
icon = mkOption {
|
||||
type = types.nullOr types.str;
|
||||
default = null;
|
||||
description = "Optional Homepage service icon";
|
||||
};
|
||||
};
|
||||
}
|
||||
);
|
||||
default = [ ];
|
||||
description = "Merged homepage service metadata contributed by repo modules.";
|
||||
};
|
||||
|
||||
options.my.homepage.widgets = with lib; mkOption {
|
||||
type = types.listOf types.attrs;
|
||||
default = [ ];
|
||||
description = "Widget definitions passed directly to services.homepage-dashboard.widgets. Each entry is an attrset like { resources = { cpu = true; memory = true; }; }.";
|
||||
};
|
||||
|
||||
options.my.profiles.homepage = with lib; {
|
||||
enable = mkEnableOption "getHomepage.dev Dashboard";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.homepage-dashboard = {
|
||||
enable = true;
|
||||
listenPort = dashboardPort;
|
||||
allowedHosts = "${dashboardHost}:${toString dashboardPort},localhost:${toString dashboardPort},127.0.0.1:${toString dashboardPort},jupiter.solar.internal:${toString dashboardPort}";
|
||||
bookmarks = import ./bookmarks.nix;
|
||||
services = homepageServices ++ manualServices;
|
||||
widgets = config.my.homepage.widgets ++ manualWidgets;
|
||||
};
|
||||
|
||||
users.users.finn.packages = with pkgs; [
|
||||
homepage-dashboard
|
||||
];
|
||||
|
||||
programs.chromium.homepageLocation = dashboardUrl;
|
||||
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,28 @@
|
||||
[
|
||||
# Example:
|
||||
{
|
||||
"Services" = [
|
||||
{
|
||||
"Tesla - Dashboard" = {
|
||||
href = "https://grafana.smoothcloud.de";
|
||||
description = "Tesla Information";
|
||||
icon = "tesla.png";
|
||||
};
|
||||
}
|
||||
{
|
||||
"GitLab" = {
|
||||
href = "https://gitlab.smoothcloud.de";
|
||||
description = "Selfhosted GitLab";
|
||||
icon = "gitlab.png";
|
||||
};
|
||||
}
|
||||
{
|
||||
"Nextcloud" = {
|
||||
href = "https://next.smoothcloud.de";
|
||||
description = "Selfhosted Cloud Service";
|
||||
icon = "nextcloud.png";
|
||||
};
|
||||
}
|
||||
];
|
||||
}
|
||||
]
|
||||
@@ -0,0 +1,6 @@
|
||||
[
|
||||
# Example:
|
||||
{ resources = { cpu = true; memory = true; disk = "/"; }; }
|
||||
{ datetime = { text_size = "xl"; format = { timeStyle = "short"; }; }; }
|
||||
{ search = {provider = "google"; focus = true; target = "_blank"; }; }
|
||||
]
|
||||
@@ -0,0 +1,46 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.hyprland;
|
||||
in
|
||||
{
|
||||
options.my.profiles.hyprland = with lib; {
|
||||
enable = mkEnableOption "hyprland env";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
programs.hyprland = {
|
||||
enable = true;
|
||||
xwayland.enable = true;
|
||||
};
|
||||
|
||||
services.displayManager.sddm.wayland.enable = true;
|
||||
services.xserver = {
|
||||
layout = "de";
|
||||
xkbVariant = "";
|
||||
};
|
||||
users.users.finn.packages = with pkgs; [
|
||||
wofi
|
||||
mako
|
||||
kitty
|
||||
hyprpaper
|
||||
waybar
|
||||
libsForQt5.dolphin
|
||||
#libsForQt5.systemsettings
|
||||
libsForQt5.polkit-kde-agent
|
||||
#xdg-desktop-portal-hyprland
|
||||
];
|
||||
hardware = {
|
||||
# Opengl
|
||||
opengl.enable = true;
|
||||
|
||||
# Most wayland compositors need this
|
||||
nvidia.modesetting.enable = true;
|
||||
};
|
||||
};
|
||||
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
# manages and downloads films
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.jellyfin;
|
||||
hostName = config.networking.hostName;
|
||||
port = 8096;
|
||||
in
|
||||
{
|
||||
options.my.profiles.jellyfin = with lib; {
|
||||
enable = mkEnableOption "Media Service";
|
||||
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.jellyfin = {
|
||||
enable = true;
|
||||
openFirewall = true;
|
||||
};
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Media";
|
||||
name = "Jellyfin";
|
||||
description = "Media server";
|
||||
href = "http://${hostName}:${toString port}";
|
||||
icon = "jellyfin.png";
|
||||
}
|
||||
];
|
||||
|
||||
systemd.services.jellyfin = {
|
||||
after = [ "network-online.target" ];
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
# manages and downloads films
|
||||
{ config, lib, ... }:
|
||||
let
|
||||
cfg = config.my.profiles.jellyseerr;
|
||||
hostName = config.networking.hostName;
|
||||
port = 5055;
|
||||
in
|
||||
{
|
||||
options.my.profiles.jellyseerr = with lib; {
|
||||
enable = mkEnableOption "JellySeerr Media Service";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.jellyseerr = {
|
||||
enable = true;
|
||||
openFirewall = true;
|
||||
};
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Media";
|
||||
name = "Jellyseerr";
|
||||
description = "Media requests";
|
||||
href = "http://${hostName}:${toString port}";
|
||||
icon = "mdi-television-guide";
|
||||
}
|
||||
];
|
||||
|
||||
systemd.services.jellyseerr = {
|
||||
after = [ "network-online.target" ];
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,27 @@
|
||||
# KDE Desktio Environment
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.kde-desktop;
|
||||
in
|
||||
{
|
||||
options.my.profiles.kde-desktop = with lib; {
|
||||
enable = mkEnableOption "KDE Desktop Environment";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services = {
|
||||
displayManager.sddm.enable = true;
|
||||
displayManager.sddm.wayland.enable = true;
|
||||
desktopManager.plasma6.enable = true;
|
||||
};
|
||||
users.users.finn.packages = with pkgs; [
|
||||
# Programms can be added here...
|
||||
numix-icon-theme
|
||||
];
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,48 @@
|
||||
# document management system
|
||||
{ config, lib, ... }:
|
||||
let
|
||||
cfg = config.my.profiles.paperless;
|
||||
hostName = config.networking.hostName;
|
||||
in
|
||||
{
|
||||
options.my.profiles.paperless = with lib; {
|
||||
enable = mkEnableOption "Paperless Server";
|
||||
|
||||
port = mkOption {
|
||||
type = types.port;
|
||||
default = 28981;
|
||||
example = 8080;
|
||||
description = "Internal port for webui";
|
||||
};
|
||||
|
||||
extraConfig = mkOption {
|
||||
type = types.attrs;
|
||||
default = { };
|
||||
example = {
|
||||
PAPERLESS_OCR_LANGUAGE = "deu+eng";
|
||||
};
|
||||
description = "Extra configuration options";
|
||||
};
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.paperless = {
|
||||
enable = true;
|
||||
address = "0.0.0.0";
|
||||
port = cfg.port;
|
||||
# settings = cfg.extraConfig;
|
||||
};
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Services";
|
||||
name = "Paperless";
|
||||
description = "Document management";
|
||||
href = "http://${hostName}:${toString cfg.port}";
|
||||
icon = "paperless-ngx.png";
|
||||
}
|
||||
];
|
||||
|
||||
networking.firewall.allowedTCPPorts = [ cfg.port ];
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,51 @@
|
||||
# manages indexes
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.prowlarr;
|
||||
hostName = config.networking.hostName;
|
||||
port = 9696;
|
||||
in
|
||||
# domain = config.networking.domain;
|
||||
# port = 9696;
|
||||
{
|
||||
options.my.profiles.prowlarr = with lib; {
|
||||
enable = mkEnableOption "Prowlarr for indexing";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.prowlarr = {
|
||||
enable = true;
|
||||
openFirewall = true;
|
||||
};
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Media";
|
||||
name = "Prowlarr";
|
||||
description = "Indexer manager";
|
||||
href = "http://${hostName}:${toString port}";
|
||||
icon = "prowlarr.png";
|
||||
}
|
||||
];
|
||||
|
||||
# # ugly fix for service not having a homedirectory
|
||||
# users.users.prowlarr = {
|
||||
# isSystemUser = true;
|
||||
# home = "/var/lib/prowlarr";
|
||||
# group = "prowlarr";
|
||||
# uid = 61654;
|
||||
# };
|
||||
# users.groups.prowlarr = {
|
||||
# gid = 61654;
|
||||
# };
|
||||
|
||||
systemd.services.prowlarr = {
|
||||
after = [ "network-online.target" ];
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,43 @@
|
||||
# manages and downloads films
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.radarr;
|
||||
hostName = config.networking.hostName;
|
||||
port = 7878;
|
||||
in
|
||||
# domain = config.networking.domain;
|
||||
# port = 7878;
|
||||
{
|
||||
options.my.profiles.radarr = with lib; {
|
||||
enable = mkEnableOption "Sonarr for films management";
|
||||
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.radarr = {
|
||||
enable = true;
|
||||
openFirewall = true;
|
||||
};
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Media";
|
||||
name = "Radarr";
|
||||
description = "Movie management";
|
||||
href = "http://${hostName}:${toString port}";
|
||||
icon = "radarr.png";
|
||||
}
|
||||
];
|
||||
|
||||
my.profiles.prowlarr.enable = true;
|
||||
|
||||
systemd.services.radarr = {
|
||||
after = [ "network-online.target" ];
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,43 @@
|
||||
# manages and downloads films
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.readarr;
|
||||
hostName = config.networking.hostName;
|
||||
port = 8787;
|
||||
in
|
||||
# domain = config.networking.domain;
|
||||
# port = 7878;
|
||||
{
|
||||
options.my.profiles.readarr = with lib; {
|
||||
enable = mkEnableOption "Readarr for ebook management";
|
||||
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.readarr = {
|
||||
enable = true;
|
||||
openFirewall = true;
|
||||
};
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Media";
|
||||
name = "Readarr";
|
||||
description = "Book management";
|
||||
href = "http://${hostName}:${toString port}";
|
||||
icon = "readarr.png";
|
||||
}
|
||||
];
|
||||
|
||||
my.profiles.prowlarr.enable = true;
|
||||
|
||||
systemd.services.readarr = {
|
||||
after = [ "network-online.target" ];
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,41 @@
|
||||
# manages and downloads films
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.sonarr;
|
||||
hostName = config.networking.hostName;
|
||||
port = 8989;
|
||||
in
|
||||
{
|
||||
options.my.profiles.sonarr = with lib; {
|
||||
enable = mkEnableOption "sonarr for series management";
|
||||
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.sonarr = {
|
||||
enable = true;
|
||||
openFirewall = true;
|
||||
};
|
||||
|
||||
my.homepage.services = [
|
||||
{
|
||||
group = "Media";
|
||||
name = "Sonarr";
|
||||
description = "Series management";
|
||||
href = "http://${hostName}:${toString port}";
|
||||
icon = "sonarr.png";
|
||||
}
|
||||
];
|
||||
|
||||
my.profiles.prowlarr.enable = true;
|
||||
|
||||
systemd.services.sonarr = {
|
||||
after = [ "network-online.target" ];
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,27 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.profiles.zsh;
|
||||
in
|
||||
{
|
||||
|
||||
options.my.profiles.zsh = with lib; {
|
||||
enable = mkEnableOption "zsh env";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
users.defaultUserShell = pkgs.zsh;
|
||||
programs.zsh = {
|
||||
enable = true;
|
||||
ohMyZsh = {
|
||||
enable = true;
|
||||
theme = "agnoster";
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
}
|
||||
@@ -0,0 +1,30 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.hardware.bluetooth;
|
||||
in
|
||||
{
|
||||
options.my.hardware.bluetooth = with lib; {
|
||||
enable = mkEnableOption "bluetooth configuration";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
hardware.bluetooth = {
|
||||
enable = true;
|
||||
package = pkgs.bluez;
|
||||
settings = {
|
||||
General = {
|
||||
Enable = "Source,Sink,Media,Socket";
|
||||
};
|
||||
};
|
||||
};
|
||||
services.blueman.enable = true;
|
||||
environment.systemPackages = with pkgs; [
|
||||
sony-headphones-client
|
||||
];
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,18 @@
|
||||
# Hardware-related modules
|
||||
{ ... }:
|
||||
|
||||
{
|
||||
imports = [
|
||||
./bluetooth
|
||||
#./debug
|
||||
#./drive-monitor
|
||||
#./firmware
|
||||
#./graphics
|
||||
#./keychron
|
||||
./nvidia
|
||||
#./yubikey
|
||||
./sound
|
||||
#./thunderbolt
|
||||
# ./wifi
|
||||
];
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.hardware.nvidia;
|
||||
in
|
||||
{
|
||||
options.my.hardware.nvidia = with lib; {
|
||||
enable = mkEnableOption "NVIDIA GPU support";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
# Enable OpenGL
|
||||
hardware.graphics = {
|
||||
enable = true;
|
||||
};
|
||||
# Load nvidia driver for Xorg and Wayland
|
||||
services.xserver.videoDrivers = ["nvidia"];
|
||||
hardware.nvidia = {
|
||||
|
||||
# Modesetting is required.
|
||||
modesetting.enable = true;
|
||||
|
||||
# Nvidia power management. Experimental, and can cause sleep/suspend to fail.
|
||||
# Enable this if you have graphical corruption issues or application crashes after waking
|
||||
# up from sleep. This fixes it by saving the entire VRAM memory to /tmp/ instead
|
||||
# of just the bare essentials.
|
||||
powerManagement.enable = false;
|
||||
|
||||
# Fine-grained power management. Turns off GPU when not in use.
|
||||
# Experimental and only works on modern Nvidia GPUs (Turing or newer).
|
||||
powerManagement.finegrained = false;
|
||||
|
||||
# Use the NVidia open source kernel module (not to be confused with the
|
||||
# independent third-party "nouveau" open source driver).
|
||||
# Support is limited to the Turing and later architectures. Full list of
|
||||
# supported GPUs is at:
|
||||
# https://github.com/NVIDIA/open-gpu-kernel-modules#compatible-gpus
|
||||
# Only available from driver 515.43.04+
|
||||
open = false;
|
||||
|
||||
# Enable the Nvidia settings menu,
|
||||
# accessible via `nvidia-settings`.
|
||||
nvidiaSettings = true;
|
||||
|
||||
# Optionally, you may need to select the appropriate driver version for your specific GPU.
|
||||
package = config.boot.kernelPackages.nvidiaPackages.stable;
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,26 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.hardware.bluetooth;
|
||||
in
|
||||
{
|
||||
options.my.hardware.sound = with lib; {
|
||||
enable = mkEnableOption "Sound configuration";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
services.pulseaudio = {
|
||||
enable = false;
|
||||
support32Bit = true;
|
||||
};
|
||||
|
||||
users.extraUsers.finn.extraGroups = [ "audio" ];
|
||||
environment.systemPackages = with pkgs; [
|
||||
headsetcontrol
|
||||
];
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,21 @@
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.hardware.wifi;
|
||||
in
|
||||
{
|
||||
options.my.hardware.wifi = with lib; {
|
||||
enable = mkEnableOption "wifi configuration";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
hardware.wifi = {
|
||||
enable = true;
|
||||
package = pkgs.rtw89-firmware;
|
||||
};
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,9 @@
|
||||
# Service-related modules
|
||||
{ ... }:
|
||||
|
||||
{
|
||||
imports = [
|
||||
./vpn
|
||||
./webserver
|
||||
];
|
||||
}
|
||||
@@ -0,0 +1,18 @@
|
||||
# self-hosted vpn
|
||||
{ config, lib, ... }:
|
||||
let
|
||||
cfg = config.my.services.vpn;
|
||||
in
|
||||
{
|
||||
options.my.services.vpn = with lib; {
|
||||
enable = mkEnableOption "Headscale VPN Setup";
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable (
|
||||
lib.mkMerge [
|
||||
{
|
||||
services.tailscale.enable = true;
|
||||
}
|
||||
]
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,247 @@
|
||||
# public webserver with reverseproxy
|
||||
{
|
||||
config,
|
||||
lib,
|
||||
pkgs,
|
||||
...
|
||||
}:
|
||||
let
|
||||
cfg = config.my.services.webserver;
|
||||
inherit (config.networking) domain;
|
||||
|
||||
virtualHostOption = lib.types.submodule {
|
||||
options = {
|
||||
subdomain = lib.mkOption {
|
||||
type = lib.types.str;
|
||||
example = "dev";
|
||||
description = ''
|
||||
Which subdomain, under config.networking.domain, to use
|
||||
for this virtual host.
|
||||
'';
|
||||
};
|
||||
homepage = {
|
||||
enable = lib.mkOption {
|
||||
type = lib.types.bool;
|
||||
default = true;
|
||||
description = ''
|
||||
Whether to expose this virtual host on homepage-dashboard.
|
||||
'';
|
||||
};
|
||||
group = lib.mkOption {
|
||||
type = lib.types.str;
|
||||
default = "Web";
|
||||
description = ''
|
||||
Homepage service group for this virtual host.
|
||||
'';
|
||||
};
|
||||
name = lib.mkOption {
|
||||
type = lib.types.str;
|
||||
default = "";
|
||||
description = ''
|
||||
Optional display name for homepage-dashboard. Defaults to the subdomain.
|
||||
'';
|
||||
};
|
||||
description = lib.mkOption {
|
||||
type = lib.types.str;
|
||||
default = "";
|
||||
description = ''
|
||||
Optional homepage-dashboard description for this virtual host.
|
||||
'';
|
||||
};
|
||||
icon = lib.mkOption {
|
||||
type = lib.types.nullOr lib.types.str;
|
||||
default = null;
|
||||
description = ''
|
||||
Optional homepage-dashboard icon for this virtual host.
|
||||
'';
|
||||
};
|
||||
};
|
||||
port = lib.mkOption {
|
||||
type = with lib.types; nullOr port;
|
||||
default = null;
|
||||
example = 8080;
|
||||
description = ''
|
||||
Which port to proxy to, through localhost, for this virtual host.
|
||||
This option is incompatible with `root`.
|
||||
'';
|
||||
};
|
||||
root = lib.mkOption {
|
||||
type = with lib.types; nullOr path;
|
||||
default = null;
|
||||
example = "/var/www/blog";
|
||||
description = ''
|
||||
The root folder for this virtual host. This option is incompatible
|
||||
with `port`.
|
||||
'';
|
||||
};
|
||||
extraConfig = lib.mkOption {
|
||||
type = with lib.types; nullOr lines;
|
||||
example = lib.literalExpression ''
|
||||
{
|
||||
locations."/socket" = {
|
||||
proxyPass = "http://localhost:8096/";
|
||||
proxyWebsockets = true;
|
||||
};
|
||||
}
|
||||
'';
|
||||
default = null;
|
||||
description = ''
|
||||
Any extra configuration that should be applied to this virtual host.
|
||||
'';
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
in
|
||||
{
|
||||
options.my.services.webserver = {
|
||||
enable = lib.mkEnableOption "webserver";
|
||||
virtualHosts = lib.mkOption {
|
||||
type = lib.types.listOf virtualHostOption;
|
||||
default = [ ];
|
||||
example = lib.literalExpression ''
|
||||
[
|
||||
{
|
||||
subdomain = "gitea";
|
||||
port = 8080;
|
||||
homepage.description = "Git forge";
|
||||
}
|
||||
{
|
||||
subdomain = "dev";
|
||||
root = "/var/www/dev";
|
||||
homepage.description = "Static site";
|
||||
}
|
||||
{
|
||||
subdomain = "jellyfin";
|
||||
port = 8096;
|
||||
homepage.group = "Media";
|
||||
homepage.description = "Media server";
|
||||
extraConfig = {
|
||||
locations."/socket" = {
|
||||
proxyPass = "http://localhost:8096/";
|
||||
proxyWebsockets = true;
|
||||
};
|
||||
};
|
||||
}
|
||||
]
|
||||
'';
|
||||
description = ''
|
||||
List of virtual hosts to set-up using default settings.
|
||||
'';
|
||||
};
|
||||
};
|
||||
|
||||
config = lib.mkIf cfg.enable {
|
||||
assertions = [
|
||||
{
|
||||
assertion = lib.allUnique (builtins.filter (p: p != null) (map (v: v.port) cfg.virtualHosts));
|
||||
message =
|
||||
let
|
||||
portsWithSubdomains = builtins.filter (v: v.port != null) cfg.virtualHosts;
|
||||
duplicates = lib.filter (
|
||||
p: builtins.length (lib.filter (x: x.port == p.port) portsWithSubdomains) > 1
|
||||
) portsWithSubdomains;
|
||||
in
|
||||
if duplicates == [ ] then
|
||||
""
|
||||
else
|
||||
"Duplicate ports found in my.services.webserver.virtualHosts: "
|
||||
+ builtins.concatStringsSep ", " (map (v: v.subdomain + ":" + builtins.toString v.port) duplicates);
|
||||
}
|
||||
];
|
||||
|
||||
my.homepage.services = map (
|
||||
vhost:
|
||||
{
|
||||
group = vhost.homepage.group;
|
||||
name = if vhost.homepage.name != "" then vhost.homepage.name else vhost.subdomain;
|
||||
description =
|
||||
if vhost.homepage.description != "" then
|
||||
vhost.homepage.description
|
||||
else if vhost.root != null then
|
||||
"Static site"
|
||||
else if vhost.port != null then
|
||||
"Reverse proxied service"
|
||||
else
|
||||
"Web service";
|
||||
href = "https://${vhost.subdomain}.${domain}";
|
||||
icon = vhost.homepage.icon;
|
||||
}
|
||||
) (builtins.filter (vhost: vhost.homepage.enable) cfg.virtualHosts);
|
||||
|
||||
services = {
|
||||
nginx.enable = false;
|
||||
caddy = {
|
||||
enable = true;
|
||||
email = "jupiter@solar.internal";
|
||||
|
||||
globalConfig = ''
|
||||
servers{
|
||||
|
||||
}
|
||||
'';
|
||||
extraConfig = ''
|
||||
(compress) {
|
||||
encode gzip zstd
|
||||
}
|
||||
(headers) {
|
||||
header {
|
||||
# enable CORS
|
||||
Access-Control-Allow-Origin "https://${config.networking.domain}"
|
||||
# disable FLoC tracking
|
||||
Permissions-Policy interest-cohort=()
|
||||
# enable HSTS
|
||||
Strict-Transport-Security max-age=31536000;
|
||||
# disable clients from sniffing the media type
|
||||
X-Content-Type-Options "nosniff"
|
||||
# clickjacking protection
|
||||
X-Frame-Options "DENY"
|
||||
# enable XSS protection
|
||||
X-XSS-Protection "1; mode=block"
|
||||
# referrer policy
|
||||
Referrer-Policy "strict-origin-when-cross-origin"
|
||||
}
|
||||
}
|
||||
(common) {
|
||||
import headers
|
||||
import compress
|
||||
}
|
||||
'';
|
||||
|
||||
virtualHosts =
|
||||
let
|
||||
mkVHost =
|
||||
{ subdomain, ... }@args:
|
||||
lib.nameValuePair "${subdomain}.${domain}" (
|
||||
lib.foldl lib.recursiveUpdate { } [
|
||||
{
|
||||
useACMEHost = domain;
|
||||
extraConfig = ''
|
||||
import common
|
||||
${lib.optionalString (args.root != null) ''
|
||||
root * ${args.root}
|
||||
file_server
|
||||
''}
|
||||
${lib.optionalString (args.port != null) ''
|
||||
reverse_proxy localhost:${toString args.port} {
|
||||
# remove CORS headers from proxied server, because duplicate headers are not allowed
|
||||
# remove after new release: https://github.com/navidrome/navidrome/commit/657fe11f5327ff7a3cb6aa9308b0bb7c71eea5c6
|
||||
header_down -Access-Control-Allow-Origin
|
||||
}
|
||||
''}
|
||||
${lib.optionalString (args.extraConfig != null) args.extraConfig}
|
||||
'';
|
||||
}
|
||||
]
|
||||
);
|
||||
in
|
||||
lib.listToAttrs (map mkVHost cfg.virtualHosts);
|
||||
};
|
||||
};
|
||||
|
||||
networking.firewall.allowedTCPPorts = [
|
||||
80
|
||||
443
|
||||
];
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,3 @@
|
||||
final: prev: {
|
||||
# homer = final.callPackage ./homer { };
|
||||
}
|
||||
Reference in New Issue
Block a user