Fix Element Calling 30000-40000 port note: single rule with both TCP and UDP

The previous change incorrectly split the 30000-40000 TURN relay range into two
rows and told users to create two separate forwarding rules. On most routers
this range is a single port-forwarding rule with a protocol selector set to
"Both" (or TCP/UDP). Revert to a single row (protocol "TCP & UDP"), update the
note to say it's one rule with both protocols enabled, and restore the totals to
3 required + 5 optional = 8.

CHANGELOG.md

@@ -1,188 +0,0 @@
-# Changelog
-
-All notable changes to Sovran_SystemsOS will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
----
-
-## [1.0.6] - 2026-08-07
-
-### Added
-- Iso: fix replaceStrings length mismatch in cleanVersion
-- Promote virtual machine trial option in README
-- Improve installer VM compatibility
-- Trim redundant dev-vs-stable Gitea explanations in README
-- Add Arean.Ai to AI tools used for development
-- Prefix OS version badge with 'v' (v1.0.5)
-- Match OS version badge styling to service modal version badges
-- Place OS version badge inline right after the Hub title
-- Center OS version badge under the Hub title
-- Strengthen entropy section: add DYOR emphasis and hardware wallet verification note
-- Add 'About Bitcoin wallet entropy' section to README
-- README: balance intro between Bitcoin sovereignty and sovereign computing
-
-### Changed
-- Removed temp patch file
-
-### Fixed
-- Resolve tag range detection and improve release diagnostics
-- Add token scope diagnostics and un-silence gh release errors
-- Harden error handling and sanitize exception details across security endpoints (CWE-209)
-- Sanitize exception handling in verify-integrity and security-reset (CWE-209)
-- Sanitize api_security_reset errors to prevent exception information exposure (CWE-209)
-- Use canonical prefix containment check for CodeQL path-injection
-- Pass sanitized abs_path to os.chown to resolve CodeQL path injection at 4338
-- Add CodeQL-recognized path sanitization for domain_name
-- Remove domain substring check for CodeQL incomplete-url
-- Use sentinel for njalla header check (CodeQL incomplete-url-substring)
-- Prevent reflected XSS in lnurl-qr print endpoint
-- Hash root password instead of storing in clear text (CWE-312)
-- Separate web auth hash from system password file
-- Fix Matrix Hub admin API credentials
-- Fix CWE-78: replace subprocess call with Synapse Admin API in create-user endpoint
-
-### Documentation
-- Add SECURITY.md detailing security policy and best practices
-- Versioned CDN downloads + add CDN upload script
-- Correct active development workflow
-- Make repo references mirror-neutral for Gitea readers
-- Clarify GitHub is the dev mirror of the Gitea stable repo
-[1.0.6]: https://git.sovransystems.com/Sovran_Systems/Sovran_SystemsOS/releases/tag/v1.0.6
-
-## [1.0.5] - 2026-08-04
-
-### Added
-- LND Update to v0.21.1-beta
-- Nixpkgs Update
-- Nixpkgs Update
-- Update LND REST Zeus Connect instructions and design to match NWC exactly
-- UI: Align LND REST and NWC Zeus connection instructions styling
-- Make Zeus LND REST instructions coherent with NWC Zeus connect guide
-- Clarify Zeus NWC wallet setup
-- Make Manual Backup match the system role (Desktop Only scope)
-- Reload Caddy immediately when a domain (or ACME email) is saved
-- Unify Njal.la + router port-forwarding guidance across onboarding and feature enable modals
-- Enhance Lightning Wallet Connect modal with professional benefits grid and refined messaging
-
-### Fixed
-- Resolve 'vdev' version badge and align it under the Hub title
-- Align release script with Gitea staging-dev and stable branch workflow
-- Auto-detect git remotes and clean up temp files in release-stable.sh
-
-### Documentation
-- Write real v1.0.4 changelog and auto-generate release notes in release script
-[1.0.5]: https://git.sovransystems.com/Sovran_Systems/Sovran_SystemsOS/releases/tag/v1.0.5
-
-
-## [Unreleased]
-
-### Fixed
-- Installer VM compatibility: legacy BIOS VM boots now install with GRUB, UEFI VM installs avoid depending on NVRAM boot-entry writes, VM users get clearer disk/resource guidance, and the internet check falls back to HTTPS when ICMP is blocked.
-- **Manual Backup now matches the system role**: on the Desktop Only role the Hub's
-  "What gets backed up" list no longer shows Node / Server + Desktop items
-  (nix-bitcoin secrets, `/var/lib` system service data, and the database/blockchain
-  caveats), and the backup script skips those stages entirely — Desktop Only backups
-  now mirror only the NixOS configuration (`/etc/nixos`) and home directory (`/home`).
-  The free-space estimate, stage numbering, backup manifest, and completion message
-  are all role-aware; Node and Server + Desktop backups are unchanged.
-
----
-
-## [1.0.4] - 2026-07-29
-
-### Added
-- **Lightning Wallet Connections (NWC)** — Hub-managed Nostr Wallet Connect powered by Alby Hub + LND:
-  - Create, view, and delete wallet connections directly from the Sovran Hub with a tabbed modal UI
-  - Downloadable/printable LNURL QR codes for connecting external wallets
-  - Channel liquidity guide and onboarding guidance for new LND nodes
-  - Unique-hostname enforcement with conflict validation and UI guidance
-  - Official NWC branding and logo
-- **Version visibility across the Hub**:
-  - Sovran_SystemsOS version badge displayed under the Hub title
-  - Version numbers shown on all Hub service tiles and next to service modal titles
-  - Deployed PHP app versions surfaced in service titles
-  - Build-time version reference file (`VERSION`) so version lookups are instantaneous and consistent
-- **Automated stable release workflow** (`scripts/release-stable.sh`) with versioned ISO naming from the `VERSION` file
-- `CONTRIBUTING.md` and expanded project documentation
-
-### Changed
-- **Manual Backup overhauled**: replaced tar+DB+LND archive approach with a reliable ext4 + rsync workflow, including
-  mount checks, path safety, atomic completion markers, stale-marker cleanup, and behavioral test coverage
-- **Port-forwarding UX simplified**: removed onboarding Step 4 and the misleading local "ready" status;
-  Njal.la DDNS now runs automatically when the feature is enabled
-- README restructured for clarity, links, and accuracy; added router/ISP port-forwarding requirements
-  for Server + Desktop mode; acknowledged LiveKit and Alby Hub
-- Updated nixpkgs and Bitcoin clients
-- Repository cleanup: removed unused `.github`, `.tests`, `nix/`, and `docs/ai` directories
-
-### Fixed
-- NWC wallet certificate path wiring (now uses the nix-bitcoin LND cert path)
-- Deterministic LND/Alby Hub port collision
-- Alby Hub executable resolution and v1.23.0 patches regenerated against exact upstream source
-- Manual Backup exit-code failures (bash/gawk in service PATH, tar tolerance, flock, browser-cache exclusions)
-- rsync destination-directory failures in backups (auto `mkdir -p`, mount check, 19 behavioral tests)
-- `sovran-hosts-update` converted to `writeShellApplication` with explicit runtime inputs
-- Incorrect `lib.mkIf` usage in the NWC wallets module
-- Duplicate systemd LND strings
-- `git fetch` tag-clobber errors against Gitea (now uses `--force`)
-
-### Security
-- Hardened Lightning Wallet Connections (NWC): restricted `ReadOnlyPaths` for the unlock password,
-  fixed an Authorization-header bug, eliminated stack-trace exposure flagged by CodeQL,
-  and tightened credential access and amount validation
-
-[1.0.4]: https://git.sovransystems.com/Sovran_Systems/Sovran_SystemsOS/releases/tag/v1.0.4
-
-
-## [1.0.3] - 2026-07-29
-
-### Added
-- Incremental stable updates
-
-## [1.0.2] - 2026-07-29
-
-### Added
-- Incremental stable updates
-
-## [1.0.1] - 2026-07-29
-
-### Added
-- Incremental stable updates
-
-## [1.0.0] - 2026-07-29
-
-### Added
-- Initial stable release of Sovran_SystemsOS
-- Full Bitcoin self-custody desktop environment
-- Integrated Sparrow Wallet, Bisq, and Bisq 2
-- Comprehensive Sovran Hub for service management
-- NixOS-based operating system with privacy and sovereignty focus
-- Support for Bitcoin Knots + BIP110, Electrs, LND, Ride The Lightning, BTCPay Server, and more
-- Server + Desktop hybrid mode with Matrix, Nextcloud, VaultWarden, and other self-hosted services
-- Automated installer with graphical GNOME desktop
-- Tor integration and onion services for all major components
-- Remote desktop (GNOME Remote Desktop) support
-- Role-based system configuration (desktop, server, server+desktop)
-- Detailed service credential management in the Sovran Hub
-
-### Changed
-- Moved from development/main branch to dedicated `stable` branch for production releases
-
-### Security
-- All services run with least-privilege principles where possible
-- Secrets stored in `/var/lib/secrets/`
-- Strong emphasis on user-controlled keys and self-sovereignty
-
----
-
-## [Unreleased]
-
-### Added
-- (Nothing yet)
-
-[1.0.3]: https://git.sovransystems.com/Sovran_Systems/Sovran_SystemsOS/releases/tag/v1.0.3
-[1.0.2]: https://git.sovransystems.com/Sovran_Systems/Sovran_SystemsOS/releases/tag/v1.0.2
-[1.0.1]: https://git.sovransystems.com/Sovran_Systems/Sovran_SystemsOS/releases/tag/v1.0.1
-[1.0.0]: https://git.sovransystems.com/Sovran_Systems/Sovran_SystemsOS/releases/tag/v1.0.0

CONTRIBUTING.md

@@ -1,105 +0,0 @@
-# Contributing to Sovran Systems OS
-
-First off, thank you for considering contributing to Sovran_SystemsOS! 🎉
-
-## Development and Release Repositories
-
-The GitHub repository is the primary location for Sovran_SystemsOS development
-and collaboration and serves as the project's connection to the GitHub
-ecosystem. Most work is contributed through feature branches and pull requests
-that target GitHub `main`. Development may also begin in a local branch or on
-`staging-dev` at the project's self-hosted Gitea instance:
-https://git.sovransystems.com/Sovran_Systems/Sovran_SystemsOS.
-
-GitHub `main` and Gitea `staging-dev` are kept synchronized as the active
-development line, although one may briefly lead the other while changes are
-being integrated. The canonical, release-ready code is maintained on Gitea's
-[`stable` branch](https://git.sovransystems.com/Sovran_Systems/Sovran_SystemsOS/src/branch/stable),
-in keeping with the self-sovereignty ethos of Sovran_SystemsOS.
-
-The workflow is:
-
-1. Most development and project collaboration — including issues, pull
-   requests, and reviews — happens through GitHub, with completed work
-   integrated into `main`.
-2. Work may also originate locally or on Gitea `staging-dev`. Accepted changes
-   are synchronized between GitHub `main` and Gitea `staging-dev`.
-3. When changes are complete and tested, they are promoted to Gitea `stable`,
-   which is the code used by released Sovran_SystemsOS builds.
-
-Please note: GitHub `main` and Gitea `staging-dev` may contain new features and
-code not yet in `stable`, and that code may not be fully tested.
-
-Moreover, Sovran_SystemsOS has been improved with the help of AI. We have used Copilot and Arean.Ai to work through significant coding challenges and troubleshooting hurdles. We will continue to use AI to help keep Sovran_SystemsOS stable and maintained.
-
-## How Can I Contribute?
-
-### 🐛 Reporting Bugs
-- Open an [Issue](https://github.com/naturallaw777/Sovran_SystemsOS/issues)
-- Use a clear and descriptive title
-- Describe the steps to reproduce the bug
-- Include your OS version, hardware specs, and any relevant logs
-
-### 💡 Suggesting Features
-- Open an [Issue](https://github.com/naturallaw777/Sovran_SystemsOS/issues) with the tag `enhancement`
-- Explain the feature and why it would be useful
-- Be as detailed as possible
-
-### 🔧 Submitting Code Changes
-
-#### 1. Fork the Repository
-Click the "Fork" button at the top right of the GitHub repository.
-
-#### 2. Clone Your Fork
-```bash
-git clone https://github.com/YOUR_USERNAME/Sovran_SystemsOS.git
-cd Sovran_SystemsOS
-```
-
-#### 3. Create a Feature Branch
-```bash
-git checkout -b feature/your-feature-name
-```
-
-#### 4. Make Your Changes
-- Write clean, well-commented code
-- Follow the existing code style and structure
-- Test your changes thoroughly
-
-#### 5. Commit Your Changes
-```bash
-git add .
-git commit -m "Brief description of your changes"
-```
-
-#### 6. Push to Your Fork
-```bash
-git push origin feature/your-feature-name
-```
-
-#### 7. Open a Pull Request
-- Go to the original repository on GitHub
-- Click "New Pull Request"
-- Select your fork and branch
-- Provide a clear title and description of your changes
-- Reference any related Issues (e.g., "Closes #12")
-
-## Pull Request Guidelines
-
-- **One PR per feature/fix.** Do not bundle unrelated changes.
-- **Keep PRs small and focused.** Smaller PRs are easier to review and merge.
-- **Write meaningful commit messages.**
-- **Do not push directly to `main`.** Always use a feature branch and open a PR.
-- **Be patient.** PRs will be reviewed as soon as possible.
-
-## Code Style
-
-- Follow the existing patterns in the codebase
-- Comment your code where necessary
-- Keep functions small and focused
-
-## Code of Conduct
-
-By participating in this project, you agree to be respectful and constructive.
-We are building something meaningful — let's do it together with integrity.
-

SECURITY.md

@@ -1,104 +0,0 @@
-# Security Policy (SECURITY.md)
-
-This document outlines the security policy, vulnerability disclosure process, threat model, and security best practices for **Sovran_SystemsOS**.
-
----
-
-## 1. Supported Versions
-
-We actively monitor and patch security vulnerabilities in Sovran_SystemsOS. Because the operating system is built on [NixOS](https://nixos.org), stable releases receive security updates backported from upstream Nixpkgs as well as our custom software updates.
-
-| Version | Supported | Notes |
-|:---|:---:|:---|
-| **1.0.x** (Stable) |  Yes | Active stable release line. Patches are backported regularly. |
-| **staging-dev** |  Yes | Development line; updated frequently but may contain untested code. |
-| **Legacy (< 1.0.0)** |  No | Please upgrade to the latest stable release to ensure you have active security updates. |
-
----
-
-## 2. Reporting a Vulnerability
-
-We take the security of self-custody systems, private clouds, and communications servers extremely seriously. If you discover a vulnerability, **please do not open a public issue, forum thread, or submit a public pull request.** 
-
-Instead, report vulnerabilities privately through one of the following secure channels:
-
-1. **Email:** Send an encrypted or plain-text email to [support@sovransystems.com](mailto:support@sovransystems.com).
-   - If sending sensitive information, please contact us first to establish a secure PGP-encrypted communication channel.
-2. **GitHub Private Vulnerability Reporting:** If you are viewing this on GitHub, you can report vulnerabilities privately via the **Security** tab of this repository under **Vulnerability reporting**.
-
-### What to Include in a Report:
-To help us triage and resolve the issue quickly, please include:
-- A clear description of the vulnerability and its potential impact.
-- Step-by-step instructions to reproduce the issue (including any scripts or configuration snippets).
-- The version of Sovran_SystemsOS you tested (found in the Hub header or `/etc/nixos/VERSION`).
-- Any potential remediation steps or suggestions you may have.
-
-### Our Response and Disclosure Process:
-1. **Acknowledgment:** We will acknowledge receipt of your report within **24–48 hours** and provide a tracking reference.
-2. **Triage:** We will investigate and verify the vulnerability privately. We may reach out to you for clarifying details.
-3. **Remediation:** If verified, we will develop a patch on a private security branch.
-4. **Release:** We will coordinate a release date with you and publish the patch to Gitea `stable` and GitHub `main`.
-5. **Advisory:** A public security advisory will be published, giving full credit to you for the discovery (unless you request anonymity).
-
-We ask that you practice **coordinated vulnerability disclosure**, giving us reasonable time to patch the vulnerability before disclosing it publicly to protect other operators' funds and data.
-
----
-
-## 3. The Sovran_SystemsOS Security Architecture
-
-Understanding our underlying threat model and architectural decisions will help you evaluate the system's security.
-
-### A. Local-First Threat Model
-- **No Cloud Dependency:** Your data, keys, and credentials live entirely on your physical hardware.
-- **Local network Hub Access:** The Sovran Hub is served directly on your local network (`sovransystemsos.local`). It is protected by authentication and **never** automatically exposed to the public internet.
-- **Localhost Auto-Login:** Auto-login to the Hub is restricted strictly to local connections from `127.0.0.1` or `::1` (e.g., when accessing it directly from the local GNOME desktop). LAN and WAN clients must authenticate via password.
-
-### B. Declarative & Reproducible NixOS Foundation
-- **No Supply Chain Drift:** Dependencies, packages, and system components are strictly pinned using Nix flakes (`flake.lock`).
-- **Reproducible Integrity Checks:** Operators can verify system integrity at any time via the Hub (`/api/security/verify-integrity`), which runs `nix store verify --all` to check binary consistency and rebuilds the system state from local files to guarantee it matches the expected configuration.
-- **Default-Hardened Base:** Firewalls are enabled by default (`networking.firewall.enable = true`), public SSH and remote desktop are disabled by default, and legacy kernel modules like `rxrpc` are blacklisted to reduce the kernel's attack surface.
-
-### C. Restricted Tech Support ("Zero-Trust Support")
-To prevent support staff or malicious actors from accessing your private wallets, the operating system employs a unique **"Zero-Trust Support"** architecture:
-- **Restricted System Account:** Support sessions use a restricted, non-root account (`sovran-support`) with heavily scoped shell access and limited `sudo` privileges (restricted strictly to viewing logs, editing configuration, and rebuilding or restarting services).
-- **POSIX ACL Wallet Lockout:** Enabling support immediately triggers POSIX ACLs (`setfacl -m u:sovran-support:---`) to block the support user from reading, writing, or traversing sensitive directories (such as `/etc/nix-bitcoin-secrets`, `/var/lib/bitcoind`, `/var/lib/lnd`, and `/home`).
-- **User-Controlled Timed Unlock:** Support staff can *only* access wallet files if the operator explicitly grants a time-limited unlock from the Hub interface. This unlock automatically expires, re-locking the directories.
-- **Tamper-Evident Auditing:** All support actions (enabling, disabling, wallet unlocking, or locking) are logged in a tamper-evident audit trail (`/var/log/sovran-support-audit.log`) readable directly by the operator.
-
-### D. Native Cryptographic Isolation
-- **Tor Network Integration:** Upstream Bitcoin services (Knots/Core, Electrs, LND) utilize native Tor integration, preventing your home IP address from leaking to the public network or third-party node providers.
-- **Isolated Lightning Wallets:** Nostr Wallet Connect (NWC) uses isolated, sandboxed Lightning wallets with specific spending limits and access presets (e.g., receive-only), keeping your main node funds completely isolated from individual apps.
-
----
-
-## 4. Security Best Practices for Operators (Users)
-
-No software can provide absolute security. You are the ultimate sovereign of your machine. Follow these best practices to keep your system and assets secure:
-
-### 🔑 1. Split Wallet Entropy
-When setting up a Bitcoin wallet, **generate your two entropy sources on separate, unconnected hardware**:
-- **Seed Phrase:** Generated by Sparrow Wallet on your Sovran_SystemsOS machine.
-- **BIP-39 Passphrase (128-bit):** Generated on a separate device (e.g., a GrapheneOS phone using a trusted password generator or offline Diceware dice).
-- *Why?* If either device is compromised, your wallet remains secure because an attacker needs **both** independent sources of randomness to recover it.
-
-### 💾 2. Implement a Robust Backup Strategy
-- **Off-Machine Backups:** Never store your only wallet backups, seed phrases, or descriptor backups on the same computer as your running wallet.
-- **Descriptor & Channel Backups:** If using Lightning (LND), regularly back up your Static Channel Backups (SCB) and store them off-site. A node hardware failure can permanently lock up channel funds without a fresh SCB.
-- **Ext4 Backups:** If using the Hub's Manual Backup utility, ensure you are backing up to a dedicated **ext4-formatted** external drive. This preserves Linux-native security metadata, permissions, and POSIX ACLs.
-
-### 🛡️ 3. Maintain Network and Access Hygiene
-- **Public SSH Off:** Keep SSH remote access disabled in the Hub unless you actively need it. If enabled, Fail2Ban is active, but you should still enforce a strong system password.
-- **Strong Diceware Passwords:** Ensure the system `free` and `root` users have strong passphrases. Avoid re-using passwords across services.
-- **Guest Networks:** Do not access the Sovran Hub over public or guest Wi-Fi networks. These networks often lack isolation, exposing local network traffic to other devices.
-- **Disable RDP When Done:** Turn off Remote Desktop (RDP) once your administrative session is finished.
-
-### 🧑‍💻 4. Hardening Support Sessions
-If you require technical support from Sovran Systems:
-- **Enable SSH and Support on-demand:** Only enable SSH Remote Access and Support sessions when actively working with a technician, and **disable** them immediately when the session is over.
-- **Confirm Removal:** The Hub's support page includes a "Verify Removal" feature. Always use it to ensure public keys have been fully stripped from the system.
-- **Restrict Wallet Access:** Only unlock your wallet directories if absolutely necessary for the support session, and choose the shortest possible duration. Re-lock manually as soon as the troubleshooting steps are complete.
-- **Review Audit Logs:** Periodically inspect the support audit log via the Hub interface to review exactly when support sessions were toggled or unlocked.
-
----
-
-Thank you for helping us maintain a highly secure, private, and sovereign computing operating system!

VERSION

@@ -1 +0,0 @@
-1.0.6

app/icons/nwc.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="128" height="120" fill="none"><g clip-path="url(#a)"><path fill="#472459" d="M127.2 65.67c-5.13 5.11-12.23 3.88-17.35-1.25l-41.4-41.6 19.4-19.47a11.35 11.35 0 0 1 18.4 3.37l21.58 56.22a2.5 2.5 0 0 1-.57 2.67l-13.63 13.57 13.58-13.51Z"/><path fill="url(#b)" d="m109.85 64.42-54.16-54.4a13.13 13.13 0 0 0-18.57-.05L3.87 43.07a13.13 13.13 0 0 0-.05 18.57l54.16 54.4a13.13 13.13 0 0 0 18.57.04l10.7-10.64 3.12-3.12-10-10.03a19.04 19.04 0 0 1-23.83-2.56l-6.8-6.85a2.46 2.46 0 0 1 0-3.5l3.35-3.32-8.4-8.46a3.67 3.67 0 0 1-.34-4.9 3.57 3.57 0 0 1 5.29-.23l8.51 8.56 6.68-6.63-8.41-8.46a3.67 3.67 0 0 1-.33-4.9 3.58 3.58 0 0 1 5.3-.24l8.5 8.57 3.36-3.34a2.47 2.47 0 0 1 3.5.01l6.8 6.84a19.03 19.03 0 0 1 2.41 23.86l10 10.03 5.69-5.67 8.16-8.12 17.4-17.31c-5.15 5.11-12.25 3.88-17.36-1.25Z"/></g><defs><linearGradient id="b" x1="63.6" x2="63.6" y1="6.15" y2="119.91" gradientUnits="userSpaceOnUse"><stop stop-color="#FFCA4A"/><stop offset="1" stop-color="#F7931A"/></linearGradient><clipPath id="a"><path fill="#fff" d="M0 0h128v119.91H0z"/></clipPath></defs></svg>

app/sovran_systemsos_web/config.py

@@ -1,4 +1,4 @@
-"""Load the Nix-generated config and build-time versions for Sovran_SystemsOS_Hub."""
+"""Load the Nix-generated config for Sovran_SystemsOS_Hub."""
 
 import json
 import os
@@ -18,23 +18,3 @@ def load_config() -> dict:
             return json.load(fh)
     except (FileNotFoundError, json.JSONDecodeError):
         return {"refresh_interval": 5, "command_method": "systemctl", "services": []}
-
-
-def load_versions() -> dict:
-    """Read the Nix-generated or fallback build-time package versions."""
-    path = os.environ.get("SOVRAN_HUB_VERSIONS")
-    if not path:
-        # Candidate 1: parent folder (same as config.json, typical for Nix layout)
-        parent_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-        candidate1 = os.path.join(parent_dir, "versions.json")
-        if os.path.exists(candidate1):
-            path = candidate1
-        else:
-            # Candidate 2: local package folder (dev folder structure)
-            path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "versions.json")
-
-    try:
-        with open(path, "r") as fh:
-            return json.load(fh)
-    except (FileNotFoundError, json.JSONDecodeError):
-        return {}

app/sovran_systemsos_web/nwc_audit.py

@@ -1,75 +0,0 @@
-"""
-Structured audit logging for NWC wallet operations.
-
-Writes append-only JSON lines to /var/log/sovran-nwc-audit.log.
-Log file is owned by albyhub:albyhub with mode 0600.
-"""
-
-from __future__ import annotations
-
-import json
-import logging
-import os
-import threading
-import time
-from typing import Any
-
-logger = logging.getLogger(__name__)
-
-AUDIT_LOG_PATH = "/var/log/sovran-nwc-audit.log"
-_AUDIT_LOCK = threading.Lock()
-_initialized = False
-
-
-def _ensure_log_file() -> None:
-    """Ensure audit log file exists with correct permissions."""
-    global _initialized
-    if _initialized:
-        return
-    with _AUDIT_LOCK:
-        if _initialized:
-            return
-        try:
-            # Create directory if needed
-            os.makedirs(os.path.dirname(AUDIT_LOG_PATH), exist_ok=True)
-            # Create file if it doesn't exist
-            if not os.path.exists(AUDIT_LOG_PATH):
-                with open(AUDIT_LOG_PATH, "w") as f:
-                    pass
-            # Set restrictive permissions
-            os.chmod(AUDIT_LOG_PATH, 0o600)
-            # Try to set ownership to albyhub user (best effort)
-            try:
-                import pwd
-                import grp
-                albyhub_uid = pwd.getpwnam("albyhub").pw_uid
-                albyhub_gid = grp.getgrnam("albyhub").gr_gid
-                os.chown(AUDIT_LOG_PATH, albyhub_uid, albyhub_gid)
-            except Exception:
-                pass  # Best effort; may not have permissions
-            _initialized = True
-        except Exception as exc:
-            logger.warning("Failed to initialize audit log: %s", exc)
-
-
-def audit_log(event: str, **fields: Any) -> None:
-    """Write a structured audit log entry.
-
-    Args:
-        event: Event type identifier (e.g., "wallet_created", "invoice_issued")
-        **fields: Additional key-value fields to include in the log entry
-    """
-    _ensure_log_file()
-
-    entry = {
-        "ts": time.time(),
-        "event": event,
-        **fields,
-    }
-
-    try:
-        with _AUDIT_LOCK:
-            with open(AUDIT_LOG_PATH, "a") as f:
-                f.write(json.dumps(entry, separators=(",", ":")) + "\n")
-    except Exception as exc:
-        logger.error("Failed to write audit log: %s", exc)

app/sovran_systemsos_web/nwc_hub_manager.py

@@ -1,881 +0,0 @@
-"""
-Alby Hub manager — shared backend for Lightning Wallet Connections API and recovery CLI.
-
-Interfaces with the local Alby Hub instance at
-http://127.0.0.1:18080 by default (override with NWC_ALBY_HUB_API_BASE).
-All sensitive values (passwords, bearer tokens, pairing URIs, macaroon
-contents, Nostr private keys) are redacted from any exception messages
-or log output.
-"""
-
-from __future__ import annotations
-
-import json
-import logging
-import os
-import re
-import secrets
-import threading
-import time
-import urllib.error
-import urllib.parse
-import urllib.request
-from typing import Any
-
-from . import nwc_audit as _audit_mod
-
-logger = logging.getLogger(__name__)
-
-# ── Constants ──────────────────────────────────────────────────────
-
-DEFAULT_API_BASE = os.environ.get(
-    "NWC_ALBY_HUB_API_BASE",
-    "http://127.0.0.1:18080",
-)
-DEFAULT_UNLOCK_PASSWORD_FILE = "/var/lib/albyhub/unlock-password"
-DEFAULT_MACAROON_FILE = os.environ.get(
-    "NWC_LND_MACAROON_FILE", "/run/lnd/albyhub.macaroon"
-)
-DEFAULT_LND_ADDRESS = os.environ.get("NWC_LND_ADDRESS", "127.0.0.1:10009")
-DEFAULT_LND_CERT_FILE = os.environ.get("NWC_LND_CERT_FILE", "/var/lib/lnd/tls.cert")
-DEFAULT_LND_SOCKET = "/run/lnd/lnd.socket"
-
-LNURL_DESCRIPTION_DEFAULT = "Pay via Lightning"
-NWC_MIN_SENDABLE_MSAT = 1000
-NWC_MAX_SENDABLE_MSAT = 1_000_000_000
-
-# Metadata key used to mark managed isolated wallets
-_MANAGED_APP_STORE_ID = "uncle-jim"
-_MANAGED_META_KEY = "app_store_app_id"
-
-RECEIVE_ONLY_SCOPES = [
-    "get_info",
-    "get_balance",
-    "make_invoice",
-    "lookup_invoice",
-    "list_transactions",
-    "notifications",
-]
-
-LIMITED_SEND_SCOPES = RECEIVE_ONLY_SCOPES + ["pay_invoice"]
-
-# ── Exceptions ─────────────────────────────────────────────────────
-
-
-class AlbyHubError(Exception):
-    """Base error from the Alby Hub manager.
-
-    The message string is safe to surface to the user — it never
-    contains raw secret material.
-    """
-
-    def __init__(self, code: str, message: str) -> None:
-        super().__init__(message)
-        self.code = code
-
-    def __str__(self) -> str:
-        return f"[{self.code}] {self.args[0]}"
-
-
-class AlbyHubHttpError(AlbyHubError):
-    def __init__(self, status_code: int, message: str) -> None:
-        super().__init__(f"http_{status_code}", message)
-        self.status_code = status_code
-
-
-# ── Manager class ──────────────────────────────────────────────────
-
-
-class AlbyHubManager:
-    """Thread-safe manager for Alby Hub API operations."""
-
-    def __init__(
-        self,
-        api_base: str = DEFAULT_API_BASE,
-        unlock_password_file: str = DEFAULT_UNLOCK_PASSWORD_FILE,
-        macaroon_file: str = DEFAULT_MACAROON_FILE,
-        lnd_address: str = DEFAULT_LND_ADDRESS,
-        lnd_cert_file: str = DEFAULT_LND_CERT_FILE,
-    ) -> None:
-        self.api_base = api_base.rstrip("/")
-        self.unlock_password_file = unlock_password_file
-        self.macaroon_file = macaroon_file
-        self.lnd_address = lnd_address
-        self.lnd_cert_file = lnd_cert_file
-        self._lock = threading.Lock()
-        self._token: str | None = None
-
-    # ── Low-level HTTP ─────────────────────────────────────────────
-
-    def _request(
-        self,
-        method: str,
-        path: str,
-        body: dict | None = None,
-        token: str | None = None,
-        timeout: int = 30,
-    ) -> dict:
-        """Make a raw HTTP request to the local Alby Hub API.
-
-        Returns the parsed JSON response body.
-        Raises AlbyHubHttpError on non-2xx responses.
-        Secrets in response bodies are never included in raised exceptions.
-        """
-        url = f"{self.api_base}{path}"
-        data = json.dumps(body).encode("utf-8") if body is not None else None
-        headers: dict[str, str] = {
-            "Content-Type": "application/json",
-            "Accept": "application/json",
-        }
-        if token:
-            headers["Authorization"] = "Bearer " + token
-        req = urllib.request.Request(url, data=data, headers=headers, method=method)
-        try:
-            with urllib.request.urlopen(req, timeout=timeout) as resp:
-                raw = resp.read()
-                if not raw:
-                    return {}
-                return json.loads(raw)
-        except urllib.error.HTTPError as exc:
-            code = exc.code
-            # Read and discard the body — we do NOT include it in the exception
-            try:
-                exc.read()
-            except Exception:
-                pass
-            raise AlbyHubHttpError(code, f"Hub API {method} {path} returned HTTP {code}") from None
-        except (urllib.error.URLError, TimeoutError, OSError):
-            raise AlbyHubError(
-                "hub_unreachable",
-                f"Hub API {method} {path} is unreachable",
-            ) from None
-
-    def _authenticated_request(
-        self,
-        method: str,
-        path: str,
-        body: dict | None = None,
-        timeout: int = 30,
-    ) -> dict:
-        """Make an authenticated request; retry once with a fresh token on 401/403."""
-        token = self.ensure_ready()
-        try:
-            return self._request(method, path, body=body, token=token, timeout=timeout)
-        except AlbyHubHttpError as exc:
-            if exc.status_code in (401, 403):
-                with self._lock:
-                    self._token = None
-                token = self.ensure_ready()
-                return self._request(method, path, body=body, token=token, timeout=timeout)
-            raise
-
-    def _paginate(self, path_template: str, page_size: int = 100) -> list[dict]:
-        """Paginate a list API completely, collecting all items.
-
-        ``path_template`` must contain ``{limit}`` and ``{offset}`` placeholders.
-        """
-        token = self.ensure_ready()
-        offset = 0
-        results: list[dict] = []
-        while True:
-            path = path_template.format(limit=page_size, offset=offset)
-            page = self._request("GET", path, token=token)
-            # Alby Hub returns apps at the top level or under "apps"/"transactions"
-            total_count: int | None = None
-            if isinstance(page, list):
-                items = page
-            elif isinstance(page, dict):
-                items = page.get("apps") or page.get("transactions") or []
-                if page.get("totalCount") is not None:
-                    total_count = int(page.get("totalCount"))
-            else:
-                items = []
-            if not isinstance(items, list):
-                break
-            results.extend(items)
-            if total_count is not None:
-                if len(results) >= total_count:
-                    break
-            elif len(items) < page_size:
-                break
-            offset += page_size
-        return results
-
-    # ── Audit log helper ───────────────────────────────────────────
-
-    def _audit(self, event: str, **fields: Any) -> None:
-        """Emit structured audit log entry."""
-        _audit_mod.audit_log(event, **fields)
-
-    # ── Startup / Auth ─────────────────────────────────────────────
-
-    def _read_unlock_password(self) -> str:
-        try:
-            with open(self.unlock_password_file, "r") as fh:
-                return fh.read().strip()
-        except OSError as exc:
-            raise AlbyHubError(
-                "unlock_password_unavailable",
-                "Cannot read Alby Hub unlock password",
-            ) from exc
-
-    def _wait_for_file(self, path: str, timeout: int = 120) -> None:
-        deadline = time.monotonic() + timeout
-        while time.monotonic() < deadline:
-            if os.path.exists(path):
-                return
-            time.sleep(2)
-        raise AlbyHubError(
-            "dependency_unavailable",
-            f"Timed out waiting for required file: {path}",
-        )
-
-    def _wait_for_hub_api(self, timeout: int = 120) -> None:
-        deadline = time.monotonic() + timeout
-        while time.monotonic() < deadline:
-            try:
-                self._request("GET", "/api/info", timeout=5)
-                return
-            except AlbyHubError:
-                pass
-            time.sleep(3)
-        raise AlbyHubError("hub_unavailable", "Timed out waiting for Alby Hub API")
-
-    def _hub_setup(self, password: str) -> None:
-        """Perform /api/setup idempotently."""
-        try:
-            info = self._request("GET", "/api/info", timeout=10)
-            if info.get("setupCompleted"):
-                return
-        except AlbyHubError:
-            pass
-
-        setup_body = {
-            "backendType": "LND",
-            "unlockPassword": password,
-            "lndAddress": self.lnd_address,
-            "lndCertFile": self.lnd_cert_file,
-            "lndMacaroonFile": self.macaroon_file,
-        }
-        try:
-            self._request("POST", "/api/setup", body=setup_body, timeout=30)
-        except AlbyHubHttpError as exc:
-            if exc.status_code == 409:
-                return  # already setup
-            raise
-
-    def _obtain_token(self, password: str) -> str:
-        info = self._request("GET", "/api/info", timeout=10)
-        if info.get("running"):
-            resp = self._request(
-                "POST",
-                "/api/unlock",
-                body={
-                    "unlockPassword": password,
-                    "permission": "full",
-                },
-                timeout=30,
-            )
-        else:
-            resp = self._request(
-                "POST",
-                "/api/start",
-                body={"unlockPassword": password},
-                timeout=30,
-            )
-        token = (
-            resp.get("token")
-            or resp.get("accessToken")
-            or resp.get("access_token")
-        )
-        if not token or not isinstance(token, str):
-            raise AlbyHubError("auth_failed", "Alby Hub auth response missing token")
-        return token
-
-    def _wait_for_node_ready(self, token: str, timeout: int = 120) -> None:
-        deadline = time.monotonic() + timeout
-        while time.monotonic() < deadline:
-            try:
-                status = self._request(
-                    "GET", "/api/node/status", token=token, timeout=10
-                )
-                if status.get("isReady") or status.get("running") or status.get("online"):
-                    return
-            except AlbyHubError:
-                pass
-            time.sleep(3)
-        raise AlbyHubError("node_not_ready", "Timed out waiting for Alby Hub node to be ready")
-
-    def ensure_ready(self) -> str:
-        """Ensure Alby Hub is set up, unlocked, and authenticated.
-
-        Returns a valid bearer token.  Caches it and uses a lock to
-        prevent concurrent setup races.
-        """
-        with self._lock:
-            if self._token:
-                return self._token
-
-            password = self._read_unlock_password()
-            self._wait_for_file(self.macaroon_file, timeout=120)
-            self._wait_for_hub_api(timeout=120)
-            self._hub_setup(password)
-            token = self._obtain_token(password)
-            self._wait_for_node_ready(token, timeout=120)
-            self._token = token
-            return token
-
-    # ── App isolation helpers ──────────────────────────────────────
-
-    @staticmethod
-    def _parse_metadata(raw: Any) -> dict:
-        if isinstance(raw, dict):
-            return raw
-        if isinstance(raw, str):
-            try:
-                result = json.loads(raw)
-                if isinstance(result, dict):
-                    return result
-            except Exception:
-                pass
-        return {}
-
-    def _is_managed_app(self, app: dict) -> bool:
-        meta = self._parse_metadata(app.get("metadata"))
-        alias = str(meta.get("lnurl_alias", "")).strip().lower()
-        return (
-            meta.get(_MANAGED_META_KEY) == _MANAGED_APP_STORE_ID
-            and bool(alias)
-        )
-
-    def _app_to_wallet_meta(self, app: dict, domain: str | None) -> dict:
-        meta = self._parse_metadata(app.get("metadata"))
-        alias = meta.get("lnurl_alias", "")
-        address = f"{alias}@{domain}" if alias and domain else None
-
-        scopes = app.get("scopes") or []
-        access_preset = (
-            "send_receive_limited" if "pay_invoice" in scopes else "receive_only"
-        )
-
-        balance_msat = int(app.get("balanceMsat", 0) or 0)
-        balance_sats = balance_msat // 1000
-        dust_msat = balance_msat % 1000
-
-        spending_limit_sats: int | None = None
-        max_amount = app.get("maxAmountSat") or 0
-        if max_amount:
-            spending_limit_sats = int(max_amount)
-
-        # Count pending transactions from the budget or transactions list
-        pending_txs = int(app.get("pendingTransactionsCount", 0) or 0)
-
-        return {
-            "id": str(app.get("id", "")),
-            "pubkey": app.get("appPubkey") or app.get("nostrPubkey") or app.get("pubkey") or "",
-            "name": app.get("name", ""),
-            "alias": alias,
-            "lightning_address": address,
-            "access_preset": access_preset,
-            "spending_limit_sats": spending_limit_sats,
-            "balance_sats": balance_sats,
-            "dust_msat": dust_msat,
-            "pending_transactions": pending_txs,
-            "created_at": app.get("createdAt") or app.get("created_at"),
-            "min_sendable_msat": int(
-                meta.get("lnurl_min_sendable_msat", NWC_MIN_SENDABLE_MSAT)
-            ),
-            "max_sendable_msat": int(
-                meta.get("lnurl_max_sendable_msat", NWC_MAX_SENDABLE_MSAT)
-            ),
-        }
-
-    def _all_managed_apps(self) -> list[dict]:
-        apps = self._paginate("/api/apps?limit={limit}&offset={offset}&order_by=created_at")
-        return [a for a in apps if a.get("isolated") and self._is_managed_app(a)]
-
-    def _find_managed_app(self, identifier: str) -> dict | None:
-        needle = identifier.strip().lower()
-        for app in self._all_managed_apps():
-            if str(app.get("id", "")).lower() == needle:
-                return app
-            pubkey = (
-                app.get("appPubkey") or app.get("nostrPubkey") or app.get("pubkey") or ""
-            ).lower()
-            if pubkey == needle:
-                return app
-        return None
-
-    # ── Public API ─────────────────────────────────────────────────
-
-    def list_wallets(self, domain: str | None = None) -> list[dict]:
-        """Return all managed isolated app wallets (no secrets)."""
-        wallets = []
-        for app in self._all_managed_apps():
-            app_copy = dict(app)
-            app_copy["pendingTransactionsCount"] = len(self._get_app_pending_txs(int(app["id"])))
-            wallets.append(self._app_to_wallet_meta(app_copy, domain))
-        return wallets
-
-    def create_wallet(
-        self,
-        name: str,
-        alias: str,
-        access_preset: str,
-        spending_limit_sats: int | None,
-        domain: str | None = None,
-    ) -> dict:
-        """Create a new isolated Alby Hub app (wallet connection).
-
-        Returns a dict containing:
-          ``wallet``      — safe metadata (no secrets)
-          ``pairing_uri`` — real Alby Hub pairingUri (returned ONCE)
-          ``result``      — creation status report
-        """
-        # Validate uniqueness
-        managed = self._all_managed_apps()
-        for a in managed:
-            meta = self._parse_metadata(a.get("metadata"))
-            if meta.get("lnurl_alias", "").lower() == alias.lower():
-                raise AlbyHubError(
-                    "alias_exists", "That Lightning Address alias is already in use."
-                )
-            if (a.get("name") or "").lower() == name.lower():
-                raise AlbyHubError(
-                    "wallet_name_exists",
-                    "That Wallet Connection name already exists.",
-                )
-
-        scopes = (
-            LIMITED_SEND_SCOPES
-            if access_preset == "send_receive_limited"
-            else RECEIVE_ONLY_SCOPES
-        )
-        max_amount = (
-            spending_limit_sats
-            if access_preset == "send_receive_limited" and spending_limit_sats
-            else 0
-        )
-
-        create_body: dict = {
-            "name": name,
-            "scopes": scopes,
-            "isolated": True,
-            "budgetRenewal": "never",
-            "maxAmountSat": max_amount,
-            "metadata": {
-                _MANAGED_META_KEY: _MANAGED_APP_STORE_ID,
-                "lnurl_alias": alias,
-                "lnurl_description": LNURL_DESCRIPTION_DEFAULT,
-                "lnurl_min_sendable_msat": NWC_MIN_SENDABLE_MSAT,
-                "lnurl_max_sendable_msat": NWC_MAX_SENDABLE_MSAT,
-            },
-        }
-
-        resp = self._authenticated_request("POST", "/api/apps", body=create_body)
-        pairing_uri: str = resp.get("pairingUri") or resp.get("pairing_uri") or ""
-        app_id = resp.get("id")
-
-        # Fetch full app details for accurate metadata
-        app_detail: dict | None = None
-        if app_id is not None:
-            try:
-                app_detail = self._authenticated_request(
-                    "GET", f"/api/v2/apps/{app_id}"
-                )
-            except AlbyHubError:
-                pass
-
-        if app_detail is None:
-            # Fallback: search recent apps for the one we just created
-            updated = self._all_managed_apps()
-            for a in updated:
-                if str(a.get("id", "")) == str(app_id):
-                    app_detail = a
-                    break
-
-        wallet_meta = self._app_to_wallet_meta(app_detail or resp, domain)
-
-        # Initial internal transfer for limited wallets
-        funding_result: dict = {"attempted": False, "success": False}
-        if (
-            access_preset == "send_receive_limited"
-            and spending_limit_sats
-            and app_id is not None
-        ):
-            funding_result["attempted"] = True
-            try:
-                self._authenticated_request(
-                    "POST",
-                    "/api/transfers",
-                    body={
-                        "toAppId": int(app_id),
-                        "amountSat": spending_limit_sats,
-                        "description": f"Initial funding for {name}",
-                    },
-                )
-                funding_result["success"] = True
-            except AlbyHubError as exc:
-                funding_result["error"] = exc.code
-                funding_result["message"] = (
-                    "The wallet was created successfully and the NWC connection secret is shown "
-                    "above, but initial funding failed. Save the NWC secret now. "
-                    "Do not recreate this wallet."
-                )
-
-        # Audit log: wallet created
-        self._audit(
-            "wallet_created",
-            wallet_id=str(app_id) if app_id else "unknown",
-            name=name,
-            alias=alias,
-            access_preset=access_preset,
-            spending_limit_sats=spending_limit_sats,
-            lightning_address=wallet_meta.get("lightning_address"),
-            funding_attempted=funding_result["attempted"],
-            funding_success=funding_result["success"],
-        )
-
-        return {
-            "wallet": wallet_meta,
-            "pairing_uri": pairing_uri,  # returned once on create only
-            "result": {
-                "wallet_created": True,
-                "secret_created": bool(pairing_uri),
-                "lightning_address_registered": bool(alias and domain),
-                "funding": funding_result,
-            },
-        }
-
-    def _get_app_balance_msat(self, app: dict) -> int:
-        return int(app.get("balanceMsat", 0) or 0)
-
-    def _get_app_pending_txs(self, app_id: int) -> list[dict]:
-        txs = self._paginate(
-            f"/api/transactions?appId={app_id}&limit={{limit}}&offset={{offset}}"
-        )
-        return [
-            t for t in txs if str(t.get("state", "")).lower() == "pending"
-        ]
-
-    def drain_wallet(self, identifier: str) -> dict:
-        """Drain all whole-satoshi funds from an isolated app to the primary wallet.
-
-        Returns ``{"ok": True, "drained_sats": N, "dust_msat": M}``.
-        Raises AlbyHubError on rejection or failure.
-        """
-        app = self._find_managed_app(identifier)
-        if app is None:
-            raise AlbyHubError("wallet_not_found", "Wallet connection not found.")
-
-        app_id = int(app["id"])
-        balance_msat = self._get_app_balance_msat(app)
-
-        if balance_msat < 0:
-            raise AlbyHubError("negative_balance", "Wallet has a negative balance.")
-
-        pending = self._get_app_pending_txs(app_id)
-        if pending:
-            raise AlbyHubError(
-                "pending_transactions",
-                "Wallet has pending transactions and cannot be drained.",
-            )
-
-        transferable_msat = (balance_msat // 1000) * 1000
-        expected_dust_msat = balance_msat - transferable_msat
-
-        if transferable_msat == 0:
-            return {"ok": True, "drained_sats": 0, "dust_msat": expected_dust_msat}
-
-        # Save original permissions
-        original_scopes = list(app.get("scopes") or [])
-        original_max = app.get("maxAmountSat") or 0
-        original_renewal = app.get("budgetRenewal") or "never"
-
-        # Temporarily grant pay_invoice scope with sufficient budget
-        app_pubkey = app.get("appPubkey") or app.get("nostrPubkey") or app.get("pubkey") or ""
-        if not app_pubkey:
-            raise AlbyHubError(
-                "app_pubkey_missing",
-                "Cannot drain app: app public key not available.",
-            )
-
-        patch_body = {
-            "scopes": sorted(set(original_scopes) | {"pay_invoice"}),
-            "maxAmountSat": 0,
-            "budgetRenewal": "never",
-        }
-        self._authenticated_request("PATCH", f"/api/apps/{app_pubkey}", body=patch_body)
-
-        drain_error: AlbyHubError | None = None
-        drained_sats = 0
-        try:
-            self._authenticated_request(
-                "POST",
-                "/api/transfers",
-                body={
-                    "fromAppId": app_id,
-                    "amountMsat": transferable_msat,
-                    "description": f"Drain isolated subwallet {app.get('name', '')}",
-                },
-            )
-            drained_sats = transferable_msat // 1000
-        except AlbyHubError as exc:
-            drain_error = exc
-        finally:
-            # Restore original permissions whether drain succeeded or not
-            restore_body = {
-                "scopes": original_scopes,
-                "maxAmountSat": original_max,
-                "budgetRenewal": original_renewal,
-            }
-            try:
-                self._authenticated_request(
-                    "PATCH", f"/api/apps/{app_pubkey}", body=restore_body
-                )
-            except AlbyHubError:
-                pass  # best-effort restore; don't mask the original error
-
-        if drain_error is not None:
-            raise drain_error
-
-        # Verify remaining balance equals expected dust
-        refreshed = self._authenticated_request("GET", f"/api/v2/apps/{app_id}")
-        remaining_msat = self._get_app_balance_msat(refreshed)
-        if remaining_msat != expected_dust_msat:
-            raise AlbyHubError(
-                "drain_incomplete",
-                "Drain verification failed: final balance does not match expected dust.",
-            )
-
-        # Audit log: wallet drained
-        self._audit(
-            "wallet_drained",
-            wallet_id=str(app_id),
-            name=app.get("name", ""),
-            alias=app.get("alias", ""),
-            drained_sats=drained_sats,
-            dust_msat=expected_dust_msat,
-        )
-
-        return {
-            "ok": True,
-            "drained_sats": drained_sats,
-            "dust_msat": expected_dust_msat,
-            "remaining_msat": remaining_msat,
-        }
-
-    def delete_wallet(self, identifier: str) -> dict:
-        """Safely drain and delete an isolated app.
-
-        Returns ``{"ok": True, "drained_sats": N}``.
-        """
-        app = self._find_managed_app(identifier)
-        if app is None:
-            raise AlbyHubError("wallet_not_found", "Wallet connection not found.")
-
-        app_id = int(app["id"])
-
-        pending = self._get_app_pending_txs(app_id)
-        if pending:
-            raise AlbyHubError(
-                "pending_transactions",
-                "Wallet has pending transactions and cannot be deleted.",
-            )
-
-        drain_result = self.drain_wallet(identifier)
-
-        # Verify no transferable balance remains
-        refreshed = self._authenticated_request("GET", f"/api/v2/apps/{app_id}")
-        remaining_msat = self._get_app_balance_msat(refreshed)
-        if remaining_msat < 0:
-            raise AlbyHubError(
-                "negative_balance",
-                "Wallet has a negative final balance and cannot be deleted.",
-            )
-        if remaining_msat >= 1000:
-            raise AlbyHubError(
-                "drain_incomplete",
-                f"Drain verification failed: funds still remain.",
-            )
-
-        # Delete by app pubkey
-        pubkey = app.get("appPubkey") or app.get("nostrPubkey") or app.get("pubkey") or ""
-        if not pubkey:
-            raise AlbyHubError(
-                "app_pubkey_missing",
-                "Cannot delete app: nostr pubkey not available.",
-            )
-        self._authenticated_request(
-            "DELETE",
-            f"/api/apps/{urllib.parse.quote(pubkey, safe='')}",
-        )
-
-        # Audit log: wallet deleted
-        self._audit(
-            "wallet_deleted",
-            wallet_id=str(app_id),
-            name=app.get("name", ""),
-            alias=app.get("alias", ""),
-            drained_sats=drain_result.get("drained_sats", 0),
-            dust_msat=remaining_msat,
-        )
-
-        return {
-            "ok": True,
-            "drained_sats": drain_result.get("drained_sats", 0),
-            "dust_msat": remaining_msat,
-        }
-
-    def issue_invoice(
-        self, app_id: int, amount_msat: int, description: str = ""
-    ) -> str:
-        """Create an LND invoice attributed to a specific isolated app.
-
-        Returns a valid BOLT11 invoice string.
-        Raises AlbyHubError if the Hub returns an invalid or misattributed invoice.
-        """
-        resp = self._authenticated_request(
-            "POST",
-            "/api/invoices",
-            body={
-                "amountMsat": amount_msat,
-                "description": description or LNURL_DESCRIPTION_DEFAULT,
-                "appId": app_id,
-            },
-        )
-        invoice: str = resp.get("invoice") or ""
-        returned_app_id = resp.get("appId")
-
-        if not invoice:
-            raise AlbyHubError("invoice_creation_failed", "Hub returned empty invoice.")
-
-        # Require a valid BOLT11 prefix (mainnet, testnet, signet, regtest)
-        if not re.match(r"^ln", invoice, re.IGNORECASE):
-            raise AlbyHubError(
-                "invalid_invoice", "Hub returned a non-BOLT11 invoice string."
-            )
-
-        if returned_app_id is None or int(returned_app_id) != app_id:
-            raise AlbyHubError(
-                "invoice_attribution_failed",
-                "Invoice attribution mismatch: returned appId does not match.",
-            )
-
-        # Audit log: invoice issued via API
-        self._audit(
-            "invoice_issued",
-            app_id=app_id,
-            amount_msat=amount_msat,
-            amount_sat=amount_msat // 1000,
-            invoice_prefix=invoice[:50] + "..." if len(invoice) > 50 else invoice,
-        )
-
-        return invoice
-
-    def find_app_by_alias(self, alias: str) -> dict | None:
-        """Find a managed isolated app by its ``lnurl_alias`` metadata field."""
-        alias_lower = alias.strip().lower()
-        for a in self._all_managed_apps():
-            meta = self._parse_metadata(a.get("metadata"))
-            if meta.get("lnurl_alias", "").lower() == alias_lower:
-                return a
-        return None
-
-    def rotate_wallet_secret(self, identifier: str) -> dict:
-        """Rotate the NWC pairing secret for a wallet connection.
-
-        Revokes the old Nostr key and generates a new pairing URI.
-        Returns the new pairing URI (shown ONCE).
-        """
-        app = self._find_managed_app(identifier)
-        if app is None:
-            raise AlbyHubError("wallet_not_found", "Wallet connection not found.")
-
-        app_id = int(app["id"])
-        app_pubkey = app.get("appPubkey") or app.get("nostrPubkey") or app.get("pubkey") or ""
-        if not app_pubkey:
-            raise AlbyHubError(
-                "app_pubkey_missing",
-                "Cannot rotate secret: app public key not available.",
-            )
-
-        # Call Alby Hub's rotate secret endpoint (if available)
-        # Alby Hub may not have this endpoint yet; fall back to re-creating the app
-        # For now, we'll delete and re-create with same metadata
-        # This is a safe operation since we drain first
-        name = app.get("name", "")
-        alias = app.get("alias", "")
-        scopes = app.get("scopes") or []
-        max_amount = app.get("maxAmountSat") or 0
-        metadata = app.get("metadata") or {}
-
-        # Drain first
-        self.drain_wallet(identifier)
-
-        # Delete old app
-        self._authenticated_request(
-            "DELETE",
-            f"/api/apps/{urllib.parse.quote(app_pubkey, safe='')}",
-        )
-
-        # Create new app with same parameters
-        create_body: dict = {
-            "name": name,
-            "scopes": scopes,
-            "isolated": True,
-            "budgetRenewal": "never",
-            "maxAmountSat": max_amount,
-            "metadata": metadata,
-        }
-
-        resp = self._authenticated_request("POST", "/api/apps", body=create_body)
-        new_pairing_uri: str = resp.get("pairingUri") or resp.get("pairing_uri") or ""
-        new_app_id = resp.get("id")
-
-        # Audit log: secret rotated
-        self._audit(
-            "wallet_secret_rotated",
-            old_wallet_id=str(app_id),
-            new_wallet_id=str(new_app_id) if new_app_id else "unknown",
-            name=name,
-            alias=alias,
-        )
-
-        return {
-            "wallet_id": str(new_app_id) if new_app_id else "",
-            "pairing_uri": new_pairing_uri,
-            "message": "New NWC connection secret generated. Save it now — it will not be shown again.",
-        }
-
-    def health(self) -> dict:
-        """Return a basic health summary."""
-        try:
-            token = self.ensure_ready()
-            status = self._request(
-                "GET", "/api/node/status", token=token, timeout=10
-            )
-            return {
-                "ok": True,
-                "hub_ready": bool(
-                    status.get("isReady") or status.get("running")
-                ),
-            }
-        except AlbyHubError as exc:
-            return {"ok": False, "error": exc.code, "message": str(exc)}
-
-
-# ── Module-level singleton ──────────────────────────────────────────
-
-_manager: AlbyHubManager | None = None
-_manager_lock = threading.Lock()
-
-
-def get_manager() -> AlbyHubManager:
-    """Return the module-level singleton AlbyHubManager."""
-    global _manager
-    if _manager is None:
-        with _manager_lock:
-            if _manager is None:
-                _manager = AlbyHubManager()
-    return _manager

app/sovran_systemsos_web/nwc_lnurl_service.py

@@ -1,307 +0,0 @@
-"""
-Dedicated LNURL service for Lightning Wallet Connections.
-
-Runs as ``nwc-lnurl.service`` on 127.0.0.1:8181 (loopback only).
-Caddy proxies the public Lightning Address domain's LNURL routes to this port.
-
-Routes:
-  GET /.well-known/lnurlp/{alias}
-  GET /lnurlp/{alias}/callback?amount=<msat>
-
-All error responses are safe for public consumption — raw Alby Hub bodies
-and internal credentials are never returned to callers.
-"""
-
-from __future__ import annotations
-
-import json
-import logging
-import os
-import re
-import time
-import urllib.parse
-from collections import defaultdict
-from http.server import BaseHTTPRequestHandler, HTTPServer
-from typing import TYPE_CHECKING
-
-from . import nwc_hub_manager as _mgr_mod
-from . import nwc_audit as _audit_mod
-
-if TYPE_CHECKING:
-    from .nwc_hub_manager import AlbyHubManager
-
-logger = logging.getLogger(__name__)
-
-# ── Configuration ─────────────────────────────────────────────────
-
-LNURL_BIND_HOST = "127.0.0.1"
-LNURL_PORT = int(os.environ.get("NWC_LNURL_PORT", "8181"))
-DOMAIN_FILE = "/var/lib/domains/lightning"
-
-NWC_ALIAS_RE = re.compile(r"^[a-z0-9][a-z0-9_-]{0,31}$")
-
-# Rate limiting configuration
-RATE_LIMIT_WINDOW_SEC = 60
-RATE_LIMIT_MAX_REQUESTS = 30
-_rate_limit_buckets: dict[str, list[float]] = defaultdict(list)
-
-# ── Helpers ───────────────────────────────────────────────────────
-
-
-def _read_domain() -> str | None:
-    try:
-        with open(DOMAIN_FILE, "r") as fh:
-            raw = fh.read(256).strip().lower()
-        # Strict FQDN validation: must be a valid hostname with at least one dot
-        # Reject localhost, IP addresses, and single-label names
-        if not re.match(r"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?(\.[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?)+$", raw):
-            return None
-        # Explicitly reject local/reserved names
-        if raw in {"localhost", "localhost.localdomain", "local"}:
-            return None
-        return raw
-    except OSError:
-        pass
-    return None
-
-
-def _check_rate_limit(client_ip: str) -> bool:
-    """Check and update rate limit bucket for client IP. Returns True if allowed."""
-    now = time.monotonic()
-    bucket = _rate_limit_buckets[client_ip]
-    # Prune old entries
-    cutoff = now - RATE_LIMIT_WINDOW_SEC
-    while bucket and bucket[0] < cutoff:
-        bucket.pop(0)
-    if len(bucket) >= RATE_LIMIT_MAX_REQUESTS:
-        return False
-    bucket.append(now)
-    return True
-
-
-def _lnurl_discovery(alias: str, manager: "AlbyHubManager", client_ip: str = "") -> tuple[dict, int]:
-    alias = alias.strip().lower()
-    if not NWC_ALIAS_RE.match(alias):
-        return {"status": "ERROR", "reason": "Unknown Lightning Address alias"}, 404
-
-    domain = _read_domain()
-    if not domain:
-        return {"status": "ERROR", "reason": "Lightning domain is not configured"}, 503
-
-    try:
-        app = manager.find_app_by_alias(alias)
-    except _mgr_mod.AlbyHubError:
-        return {"status": "ERROR", "reason": "Service temporarily unavailable"}, 503
-
-    if app is None:
-        return {"status": "ERROR", "reason": "Unknown Lightning Address alias"}, 404
-
-    meta = _mgr_mod.AlbyHubManager._parse_metadata(app.get("metadata"))
-    min_sendable = int(
-        meta.get("lnurl_min_sendable_msat", _mgr_mod.NWC_MIN_SENDABLE_MSAT)
-    )
-    max_sendable = int(
-        meta.get("lnurl_max_sendable_msat", _mgr_mod.NWC_MAX_SENDABLE_MSAT)
-    )
-
-    callback_alias = urllib.parse.quote(alias, safe="")
-    callback = f"https://{domain}/lnurlp/{callback_alias}/callback"
-    description = meta.get("lnurl_description") or f"Pay {alias}"
-    metadata = json.dumps([["text/plain", description]], separators=(",", ":"))
-
-    # Audit log: LNURL discovery
-    _audit_mod.audit_log(
-        "lnurl_discovery",
-        alias=alias,
-        domain=domain,
-        client_ip=client_ip,
-        min_sendable_msat=min_sendable,
-        max_sendable_msat=max_sendable,
-    )
-
-    return {
-        "tag": "payRequest",
-        "callback": callback,
-        "minSendable": min_sendable,
-        "maxSendable": max_sendable,
-        "metadata": metadata,
-        "commentAllowed": 0,
-    }, 200
-
-
-def _lnurl_callback(
-    alias: str, amount_str: str | None, manager: "AlbyHubManager", client_ip: str = ""
-) -> tuple[dict, int]:
-    payload, status_code = _lnurl_discovery(alias, manager, client_ip)
-    if status_code != 200:
-        return payload, status_code
-
-    if amount_str is None:
-        return {"status": "ERROR", "reason": "Missing amount parameter"}, 400
-    if not re.match(r"^\d+$", amount_str):
-        return {
-            "status": "ERROR",
-            "reason": "Amount must be an integer millisatoshi value",
-        }, 400
-
-    amount_msat = int(amount_str)
-    min_sendable = int(payload["minSendable"])
-    max_sendable = int(payload["maxSendable"])
-
-    if amount_msat < min_sendable:
-        return {
-            "status": "ERROR",
-            "reason": "Amount is below the minimum sendable value",
-        }, 400
-    if amount_msat > max_sendable:
-        return {
-            "status": "ERROR",
-            "reason": "Amount is above the maximum sendable value",
-        }, 400
-    if amount_msat % 1000 != 0:
-        return {
-            "status": "ERROR",
-            "reason": "Amount must be a whole-satoshi value",
-        }, 400
-
-    try:
-        app = manager.find_app_by_alias(alias)
-    except _mgr_mod.AlbyHubError:
-        return {"status": "ERROR", "reason": "Service temporarily unavailable"}, 503
-
-    if app is None:
-        return {"status": "ERROR", "reason": "Unknown Lightning Address alias"}, 404
-
-    meta = _mgr_mod.AlbyHubManager._parse_metadata(app.get("metadata"))
-    description = meta.get("lnurl_description") or f"Pay {alias}"
-
-    try:
-        app_id = int(app["id"])
-        invoice = manager.issue_invoice(app_id, amount_msat, description)
-    except _mgr_mod.AlbyHubError:
-        return {"status": "ERROR", "reason": "Invoice creation failed"}, 502
-
-    # Audit log: Invoice generated via LNURL
-    _audit_mod.audit_log(
-        "lnurl_invoice_created",
-        alias=alias,
-        amount_msat=amount_msat,
-        amount_sat=amount_msat // 1000,
-        client_ip=client_ip,
-        invoice_prefix=invoice[:50] + "..." if len(invoice) > 50 else invoice,
-    )
-
-    return {"pr": invoice, "routes": []}, 200
-
-
-# ── HTTP server ───────────────────────────────────────────────────
-
-
-def _make_handler(manager: "AlbyHubManager") -> type:
-    """Return a handler class bound to the given manager."""
-
-    class LnurlHandler(BaseHTTPRequestHandler):
-        _manager = manager
-
-        def log_message(self, fmt: str, *args: object) -> None:
-            logger.debug(f"LNURL {self.address_string()} {fmt % args}")
-
-        def _send_json(self, status: int, body: dict) -> None:
-            raw = json.dumps(body, separators=(",", ":")).encode("utf-8")
-            self.send_response(status)
-            self.send_header("Content-Type", "application/json")
-            self.send_header("Content-Length", str(len(raw)))
-            self.end_headers()
-            self.wfile.write(raw)
-
-        def _get_client_ip(self) -> str:
-            # Check X-Forwarded-For header (set by Caddy)
-            forwarded = self.headers.get("X-Forwarded-For")
-            if forwarded:
-                # Take the first IP in the chain
-                return forwarded.split(",")[0].strip()
-            # Fallback to direct connection IP
-            return self.client_address[0]
-
-        def _check_rate_limit(self) -> bool:
-            client_ip = self._get_client_ip()
-            if not _check_rate_limit(client_ip):
-                self._send_json(429, {
-                    "status": "ERROR",
-                    "reason": "Rate limit exceeded. Please slow down."
-                })
-                _audit_mod.audit_log(
-                    "rate_limit_exceeded",
-                    client_ip=client_ip,
-                    path=self.path,
-                )
-                return False
-            return True
-
-        def do_GET(self) -> None:  # noqa: N802
-            if not self._check_rate_limit():
-                return
-
-            parsed = urllib.parse.urlparse(self.path)
-            path = parsed.path
-            qs = urllib.parse.parse_qs(parsed.query)
-            client_ip = self._get_client_ip()
-
-            # /.well-known/lnurlp/{alias}
-            m = re.fullmatch(
-                r"/.well-known/lnurlp/([^/]+)", path
-            )
-            if m:
-                alias = urllib.parse.unquote(m.group(1))
-                payload, code = _lnurl_discovery(alias, self._manager, client_ip)
-                self._send_json(code, payload)
-                return
-
-            # /lnurlp/{alias}/callback
-            m = re.fullmatch(r"/lnurlp/([^/]+)/callback", path)
-            if m:
-                alias = urllib.parse.unquote(m.group(1))
-                amount_values = qs.get("amount")
-                if not amount_values:
-                    amount_str = None
-                elif len(amount_values) != 1:
-                    self._send_json(
-                        400,
-                        {
-                            "status": "ERROR",
-                            "reason": "A single amount parameter is required",
-                        },
-                    )
-                    return
-                else:
-                    amount_str = amount_values[0]
-                payload, code = _lnurl_callback(alias, amount_str, self._manager, client_ip)
-                self._send_json(code, payload)
-                return
-
-            self._send_json(404, {"status": "ERROR", "reason": "Not found"})
-
-    return LnurlHandler
-
-
-def run(
-    host: str = LNURL_BIND_HOST,
-    port: int = LNURL_PORT,
-    manager: "AlbyHubManager | None" = None,
-) -> None:
-    """Start the blocking LNURL HTTP server."""
-    if manager is None:
-        manager = _mgr_mod.get_manager()
-    handler_class = _make_handler(manager)
-    server = HTTPServer((host, port), handler_class)
-    logger.info("nwc-lnurl service listening on %s:%d", host, port)
-    server.serve_forever()
-
-
-def main() -> None:
-    logging.basicConfig(level=logging.INFO)
-    run()
-
-
-if __name__ == "__main__":
-    main()

app/sovran_systemsos_web/nwc_wallet_cli.py

@@ -1,131 +0,0 @@
-from __future__ import annotations
-
-import argparse
-import json
-import sys
-
-from . import nwc_hub_manager as _mgr_mod
-from .server import _nwc_domain, _nwc_validate_alias, _nwc_test_address
-
-
-def _print(data) -> None:
-    print(json.dumps(data, indent=2, sort_keys=True))
-
-
-def main(argv: list[str] | None = None) -> int:
-    parser = argparse.ArgumentParser(prog="nwc-wallet")
-    sub = parser.add_subparsers(dest="cmd", required=True)
-
-    create = sub.add_parser("create")
-    create.add_argument("name")
-    create.add_argument("alias")
-    preset_group = create.add_mutually_exclusive_group()
-    preset_group.add_argument("--receive-only", action="store_true")
-    preset_group.add_argument("--limit-sats", type=int)
-
-    sub.add_parser("list")
-
-    drain = sub.add_parser("drain")
-    drain.add_argument("wallet")
-
-    delete = sub.add_parser("delete")
-    delete.add_argument("wallet")
-
-    addr = sub.add_parser("address")
-    addr_sub = addr.add_subparsers(dest="address_cmd", required=True)
-    addr_show = addr_sub.add_parser("show")
-    addr_show.add_argument("alias")
-
-    rotate = sub.add_parser("rotate")
-    rotate.add_argument("wallet")
-
-    sub.add_parser("health")
-
-    args = parser.parse_args(argv)
-    manager = _mgr_mod.get_manager()
-    domain = _nwc_domain()
-
-    if args.cmd == "list":
-        try:
-            wallets = manager.list_wallets(domain)
-        except _mgr_mod.AlbyHubError as exc:
-            print(f"Error: {exc.code} - {exc}", file=sys.stderr)
-            return 1
-        _print({"wallets": wallets})
-        return 0
-
-    if args.cmd == "health":
-        result = manager.health()
-        _print(result)
-        return 0 if result.get("ok") else 1
-
-    if args.cmd == "address" and args.address_cmd == "show":
-        alias = args.alias.strip().lower()
-        test = _nwc_test_address(alias)
-        _print(test)
-        return 0 if test.get("ok") else 1
-
-    if args.cmd == "drain":
-        try:
-            result = manager.drain_wallet(args.wallet)
-        except _mgr_mod.AlbyHubError as exc:
-            print(f"Error: {exc.code} - {exc}", file=sys.stderr)
-            return 1
-        _print(result)
-        return 0
-
-    if args.cmd == "delete":
-        try:
-            result = manager.delete_wallet(args.wallet)
-        except _mgr_mod.AlbyHubError as exc:
-            print(f"Error: {exc.code} - {exc}", file=sys.stderr)
-            return 1
-        _print(result)
-        return 0
-
-    if args.cmd == "rotate":
-        try:
-            result = manager.rotate_wallet_secret(args.wallet)
-        except _mgr_mod.AlbyHubError as exc:
-            print(f"Error: {exc.code} - {exc}", file=sys.stderr)
-            return 1
-        _print({
-            "wallet_id": result.get("wallet_id", ""),
-            "pairing_uri": result.get("pairing_uri", ""),
-            "message": result.get("message", "New NWC connection secret generated. Save it now — it will not be shown again."),
-        })
-        return 0
-
-    if args.cmd == "create":
-        alias = args.alias.strip().lower()
-        if not _nwc_validate_alias(alias):
-            print("Error: alias_invalid - Alias must be lowercase letters, digits, '_' or '-'.", file=sys.stderr)
-            return 1
-        access_preset = "send_receive_limited" if args.limit_sats is not None else "receive_only"
-        try:
-            result = manager.create_wallet(
-                args.name.strip(),
-                alias,
-                access_preset,
-                args.limit_sats if access_preset == "send_receive_limited" else None,
-                domain,
-            )
-        except _mgr_mod.AlbyHubError as exc:
-            print(f"Error: {exc.code} - {exc}", file=sys.stderr)
-            return 1
-        # Print the pairing URI once — this is the only time it is shown
-        _print(
-            {
-                "wallet": result["wallet"],
-                "pairing_uri": result.get("pairing_uri", ""),
-                "message": "Keep the NWC connection secret private. It cannot be displayed again.",
-                "result": result.get("result", {}),
-            }
-        )
-        return 0
-
-    return 1
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

app/sovran_systemsos_web/scripts/sovran-hub-backup.sh

@@ -1,29 +1,12 @@
 #!/usr/bin/env bash
 # ── Sovran Hub External Backup Script ────────────────────────────
-# Backs up Sovran_SystemsOS data to an external USB hard drive using rsync.
+# Backs up Sovran_SystemsOS data to an external USB hard drive.
 # Designed for the Hub web UI (no GUI dependencies).
 #
-# On Server + Desktop and Node systems, your Sovran Pro already backs up
-# your data automatically to its internal second drive (BTCEcoandBackup at
-# /run/media/Second_Drive); this script stores a copy in a third location.
-# Desktop Only systems have no internal second drive, so the external copy
-# is the second location.
-#
-# What gets mirrored depends on the system role:
-#   - Node / Server + Desktop: /etc/nixos, /etc/nix-bitcoin-secrets,
-#     /home, and /var/lib (minus databases, blockchain data, logs, caches).
-#   - Desktop Only: /etc/nixos and /home. Desktop Only runs no server or
-#     Bitcoin services, so there are no nix-bitcoin secrets or system
-#     service data to back up.
-#
-# The external drive must be formatted as ext4. Files are stored as
-# directly browsable files under Sovran_SystemsOS_Backup/current/.
-# Later runs update the same mirror and only transfer changed or new
-# files, making repeat backups fast.
-#
-# PostgreSQL and MariaDB/MySQL databases are NOT included. Bitcoin
-# blockchain and Electrs index data are NOT included (they live on
-# the internal second drive).
+# Your Sovran Pro already backs up your data automatically to its
+# internal second drive (BTCEcoandBackup at /run/media/Second_Drive).
+# This script creates an additional copy on an external USB drive —
+# storing your data in a third location for maximum protection.
 #
 # Usage:
 #   BACKUP_TARGET=/run/media/<user>/<drive> bash sovran-hub-backup.sh
@@ -34,28 +17,18 @@ set -euo pipefail
 BACKUP_LOG="/var/log/sovran-hub-backup.log"
 BACKUP_STATUS="/var/log/sovran-hub-backup.status"
 MEDIA_ROOT="/run/media"
+MIN_FREE_GB=10
 HUB_CONFIG_JSON="/var/lib/sovran-hub/config.json"
 ROLE_STATE_NIX="/etc/nixos/role-state.nix"
-SECOND_DRIVE_MOUNT="/run/media/Second_Drive"
-SAFETY_MARGIN_BYTES=$((1024 * 1024 * 1024))
 
 # ── Internal drive labels/paths to NEVER use as backup targets ───
 INTERNAL_LABELS=("BTCEcoandBackup" "sovran_systemsos")
-INTERNAL_MOUNTS=("$SECOND_DRIVE_MOUNT" "/boot/efi" "/")
-
-FAILED_ALREADY=0
-BACKUP_COMPLETE=0
-RSYNC_WARNINGS=()
-
-# Stable rsync mirror sub-path under the target drive. Not timestamped
-# so later runs update the same destination and only transfer new or changed files.
-BACKUP_SUBPATH="Sovran_SystemsOS_Backup/current"
+INTERNAL_MOUNTS=("/run/media/Second_Drive" "/boot/efi" "/")
 
 # ── Logging helpers ──────────────────────────────────────────────
 
 log() {
-  local msg
-  msg="[$(date '+%Y-%m-%d %H:%M:%S')] $*"
+  local msg="[$(date '+%Y-%m-%d %H:%M:%S')] $*"
   echo "$msg" | tee -a "$BACKUP_LOG"
 }
 
@@ -64,47 +37,16 @@ set_status() {
 }
 
 fail() {
-  FAILED_ALREADY=1
   log "ERROR: $*"
   set_status "FAILED"
   exit 1
 }
 
-cleanup() {
-  local rc=$?
-
-  # Release the concurrency lock file descriptor if it was opened
-  if [[ -n "${LOCK_FD:-}" ]]; then
-    exec {LOCK_FD}>&- 2>/dev/null || true
-  fi
-
-  if [[ "$BACKUP_COMPLETE" -eq 1 && "$rc" -eq 0 ]]; then
-    return
-  fi
-
-  if [[ "$FAILED_ALREADY" -eq 0 ]]; then
-    log "ERROR: Backup terminated unexpectedly (exit code $rc)."
-    set_status "FAILED"
-  fi
-
-  # Mark the backup directory as incomplete so failed runs are identifiable
-  if [[ -n "${BACKUP_DIR:-}" && -d "${BACKUP_DIR:-}" && ! -f "${BACKUP_DIR:-}/BACKUP_COMPLETE" ]]; then
-    touch "${BACKUP_DIR}/INCOMPLETE" 2>/dev/null || true
-  fi
-}
-
-trap cleanup EXIT
-trap 'exit 1' INT TERM
-
-require_cmd() {
-  local cmd="$1"
-  command -v "$cmd" >/dev/null 2>&1 || fail "Required command not found: $cmd"
-}
-
 # ── Check whether a mount point is an internal drive ────────────
 
 is_internal() {
   local mnt="$1"
+  # Reject known internal mount points and their subdirectories
   for internal in "${INTERNAL_MOUNTS[@]}"; do
     if [[ "$mnt" == "$internal" || "$mnt" == "${internal}/"* ]]; then
       return 0
@@ -117,37 +59,39 @@ is_internal() {
 
 find_external_drive() {
   local target=""
+  # lsblk JSON output: NAME,LABEL,MOUNTPOINT,HOTPLUG,RM,TYPE
+  if command -v lsblk &>/dev/null; then
+    while IFS=$'\t' read -r dev_type hotplug removable label mountpoint; do
+      # Must be a partition or disk, and be removable/hotplug
+      [[ "$dev_type" == "part" || "$dev_type" == "disk" ]] || continue
+      [[ "$hotplug" == "1" || "$removable" == "1" ]] || continue
+      [[ -n "$mountpoint" ]] || continue
 
-  while IFS=$'\t' read -r dev_type hotplug removable label mountpoint; do
-    [[ "$dev_type" == "part" || "$dev_type" == "disk" ]] || continue
-    [[ "$hotplug" == "1" || "$removable" == "1" ]] || continue
-    [[ -n "$mountpoint" ]] || continue
+      # Filter out internal labels
+      local skip=0
+      for lbl in "${INTERNAL_LABELS[@]}"; do
+        [[ "$label" == "$lbl" ]] && skip=1 && break
+      done
+      [[ "$skip" -eq 1 ]] && continue
 
-    local skip=0
-    for lbl in "${INTERNAL_LABELS[@]}"; do
-      [[ "$label" == "$lbl" ]] && skip=1 && break
-    done
-    [[ "$skip" -eq 1 ]] && continue
+      # Filter out internal mount points
+      is_internal "$mountpoint" && continue
 
-    is_internal "$mountpoint" && continue
-
-    if mountpoint -q "$mountpoint" 2>/dev/null; then
-      target="$mountpoint"
-      break
-    fi
-  done < <(lsblk -J -o NAME,LABEL,MOUNTPOINT,HOTPLUG,RM,TYPE 2>/dev/null | \
-    python3 -c "
+      if mountpoint -q "$mountpoint" 2>/dev/null; then
+        target="$mountpoint"
+        break
+      fi
+    done < <(lsblk -J -o NAME,LABEL,MOUNTPOINT,HOTPLUG,RM,TYPE 2>/dev/null | \
+      python3 -c "
 import sys, json
-
+data = json.load(sys.stdin)
 def flatten(devs):
     for d in devs:
         yield d
         for c in d.get('children', []):
             yield from flatten([c])
-
-data = json.load(sys.stdin)
 for d in flatten(data.get('blockdevices', [])):
-    print('\\t'.join([
+    print('\t'.join([
         d.get('type') or '',
         str(d.get('hotplug') or '0'),
         str(d.get('rm') or '0'),
@@ -155,10 +99,24 @@ for d in flatten(data.get('blockdevices', [])):
         d.get('mountpoint') or '',
     ]))
 " 2>/dev/null || true)
+  fi
 
+  # Fallback: walk /run/media/ if lsblk produced nothing
   if [[ -z "$target" && -d "$MEDIA_ROOT" ]]; then
     while IFS= read -r -d '' mnt; do
       is_internal "$mnt" && continue
+      # Check label via lsblk on the device backing this mount
+      local dev
+      dev=$(findmnt -n -o SOURCE "$mnt" 2>/dev/null || true)
+      if [[ -n "$dev" ]]; then
+        local lbl
+        lbl=$(lsblk -n -o LABEL "$dev" 2>/dev/null || true)
+        local skip=0
+        for internal_lbl in "${INTERNAL_LABELS[@]}"; do
+          [[ "$lbl" == "$internal_lbl" ]] && skip=1 && break
+        done
+        [[ "$skip" -eq 1 ]] && continue
+      fi
       if mountpoint -q "$mnt" 2>/dev/null; then
         target="$mnt"
         break
@@ -170,10 +128,16 @@ for d in flatten(data.get('blockdevices', [])):
 }
 
 # ── Detect the configured system role ───────────────────────────
+#
+# Priority:
+#   1. Hub config JSON  (/var/lib/sovran-hub/config.json)  — "role" key
+#   2. role-state.nix   (/etc/nixos/role-state.nix)        — grep for true flag
+#   3. Default: server_plus_desktop
 
 detect_role() {
   local role="server_plus_desktop"
 
+  # 1. Try the Hub config JSON
   if [[ -f "$HUB_CONFIG_JSON" ]] && command -v python3 &>/dev/null; then
     local r
     r=$(python3 -c \
@@ -185,6 +149,7 @@ detect_role() {
     fi
   fi
 
+  # 2. Fall back to parsing role-state.nix
   if [[ -f "$ROLE_STATE_NIX" ]]; then
     if grep -q 'roles\.desktop = lib\.mkDefault true' "$ROLE_STATE_NIX" 2>/dev/null; then
       role="desktop"
@@ -196,119 +161,6 @@ detect_role() {
   echo "$role"
 }
 
-validate_target_mount() {
-  local target="$1"
-  [[ "$target" == "${MEDIA_ROOT}/"* ]] || fail "Target '$target' must be mounted under $MEDIA_ROOT."
-  [[ -d "$target" ]] || fail "Target path '$target' does not exist."
-  mountpoint -q "$target" || fail "Target path '$target' is not a mount point."
-
-  local fstype=""
-  fstype=$(findmnt -n -o FSTYPE -T "$target" 2>/dev/null || true)
-  [[ -n "$fstype" ]] || fail "Could not determine filesystem type for '$target'."
-
-  if [[ "$fstype" != "ext4" ]]; then
-    fail "Target '$target' must be formatted as ext4 (detected filesystem: $fstype). Manual Backup requires an ext4-formatted external drive for Linux metadata preservation. exFAT, FAT32, and NTFS are not supported."
-  fi
-
-  local write_test
-  write_test="$target/.sovran-write-test-$$"
-  if ! ( : > "$write_test" && echo "ok" >> "$write_test" && rm -f "$write_test" ); then
-    fail "Target '$target' is not writable."
-  fi
-
-  log "Verified backup target filesystem: $fstype"
-}
-
-estimate_path_bytes() {
-  local path="$1"
-  shift || true
-  [[ -e "$path" ]] || {
-    echo 0
-    return
-  }
-
-  local size
-  size=$(du -s -B1 -x "$@" "$path" 2>/dev/null | awk '{print $1}' || true)
-  [[ -n "$size" ]] || size=0
-  echo "$size"
-}
-
-# ── Sync one source tree to its backup destination ───────────────
-# Usage: sync_tree <label> <allow_vanished> <source> <destination> [rsync options...]
-#
-# allow_vanished: "yes" means rsync exit 24 (vanished files) is nonfatal.
-# Used for /home only — files may disappear while the desktop is active.
-# All other nonzero exit codes are always fatal.
-#
-# Before every rsync call this helper:
-#   1. Re-verifies $TARGET is still a mount point (fails if drive disconnected).
-#   2. Verifies the destination path remains beneath $BACKUP_DIR and $BACKUP_DIR
-#      remains beneath $TARGET (safe-path check).
-#   3. Creates the full destination directory hierarchy with mkdir -p so that
-#      rsync never fails trying to create a directory whose parent is absent.
-sync_tree() {
-  local label="$1"
-  local allow_vanished="$2"
-  local source="$3"
-  local destination="$4"
-  shift 4
-  # Remaining "$@" are rsync options (--exclude, etc.)
-
-  # ── Re-verify the external drive is still mounted ────────────────
-  mountpoint -q "$TARGET" 2>/dev/null || \
-    fail "Stage $label: external drive '$TARGET' is no longer mounted. Refusing to write."
-
-  # ── Verify path safety ────────────────────────────────────────────
-  # BACKUP_DIR must remain beneath TARGET.
-  case "$BACKUP_DIR" in
-    "$TARGET"/*) ;;
-    *) fail "Stage $label: BACKUP_DIR '$BACKUP_DIR' is outside TARGET '$TARGET'." ;;
-  esac
-  # Destination must remain beneath BACKUP_DIR.
-  case "$destination" in
-    "$BACKUP_DIR"/*|"$BACKUP_DIR") ;;
-    *) fail "Stage $label: destination '$destination' is outside BACKUP_DIR '$BACKUP_DIR'. Refusing to write." ;;
-  esac
-
-  # ── Create complete destination directory hierarchy ───────────────
-  # This is the fix for the production failure:
-  #   rsync: [Receiver] mkdir ".../current/etc/nixos" failed: No such file or directory
-  # mkdir -p creates all intermediate parents (e.g. current/etc/) before rsync runs.
-  mkdir -p -- "$destination" || \
-    fail "Stage $label: failed to create destination directory '$destination' (source: '$source')."
-
-  local rsync_err_tmp
-  rsync_err_tmp="$(mktemp /tmp/sovran-rsync-err.XXXXXX)"
-
-  local rc=0
-  rsync \
-    --archive \
-    --acls \
-    --xattrs \
-    --hard-links \
-    --numeric-ids \
-    --one-file-system \
-    --partial \
-    "$@" "$source" "$destination" 2>"$rsync_err_tmp" || rc=$?
-
-  if [[ -s "$rsync_err_tmp" ]]; then
-    while IFS= read -r rline; do
-      log "rsync: $rline"
-    done < "$rsync_err_tmp"
-  fi
-  rm -f "$rsync_err_tmp"
-
-  if [[ "$rc" -eq 0 ]]; then
-    return 0
-  elif [[ "$allow_vanished" == "yes" && "$rc" -eq 24 ]]; then
-    log "NOTE: $label — some files vanished during sync (normal on an active desktop). Your important data is backed up."
-    RSYNC_WARNINGS+=("$label: some files vanished during sync (rsync exit 24 — normal on active desktop)")
-    return 0
-  else
-    fail "rsync failed for $label (exit code $rc). See the rsync errors above."
-  fi
-}
-
 # ── Initialise log file ──────────────────────────────────────────
 
 : > "$BACKUP_LOG"
@@ -317,58 +169,22 @@ set_status "RUNNING"
 log "=== Sovran_SystemsOS External Hub Backup ==="
 log "Starting backup process…"
 
-# ── Acquire exclusive run lock ────────────────────────────────────
-# Prevents two simultaneous backup runs (e.g. from double-click or
-# stale RUNNING status after a Hub restart).
-
-LOCK_FILE="/var/lock/sovran-hub-backup.lock"
-# Note: exec {LOCK_FD}>>file requires bash 4.1+ (NixOS provides bash 5.x).
-exec {LOCK_FD}>>"$LOCK_FILE" 2>/dev/null || \
-  fail "Cannot open lock file: $LOCK_FILE. Ensure /var/lock is writable."
-flock --nonblock "$LOCK_FD" 2>/dev/null || \
-  fail "Another backup is already running. Wait for it to complete or check $BACKUP_STATUS."
-
-require_cmd rsync
-require_cmd findmnt
-require_cmd lsblk
-require_cmd mountpoint
-require_cmd df
-require_cmd du
-require_cmd awk
-require_cmd find
-require_cmd hostname
-require_cmd date
-require_cmd python3
-require_cmd flock
-
 # ── Detect system role ───────────────────────────────────────────
 
 ROLE="$(detect_role)"
 case "$ROLE" in
-  desktop)              ROLE_LABEL="Desktop Only" ;;
-  node)                 ROLE_LABEL="Node (Bitcoin-only)" ;;
-  server_plus_desktop)  ROLE_LABEL="Server + Desktop" ;;
-  *)                    ROLE_LABEL="$ROLE" ;;
+  desktop)            ROLE_LABEL="Desktop Only" ;;
+  node)               ROLE_LABEL="Node (Bitcoin-only)" ;;
+  server_plus_desktop) ROLE_LABEL="Server + Desktop" ;;
+  *)                  ROLE_LABEL="$ROLE" ;;
 esac
 log "Detected role: $ROLE_LABEL"
 
-# Backup scope depends on the role. Desktop Only systems run no server or
-# Bitcoin services, so only the NixOS configuration and home directory are
-# mirrored (2 stages). Node and Server + Desktop systems also mirror the
-# nix-bitcoin secrets and /var/lib system service data (4 stages).
-if [[ "$ROLE" == "desktop" ]]; then
-  TOTAL_STAGES=2
-  HOME_STAGE_NUM=2
-  log "Desktop Only role: backing up the NixOS configuration (/etc/nixos) and home directory (/home) only."
-else
-  TOTAL_STAGES=4
-  HOME_STAGE_NUM=3
-fi
-
 # ── Detect target drive ──────────────────────────────────────────
 
 if [[ -n "${BACKUP_TARGET:-}" ]]; then
   TARGET="$BACKUP_TARGET"
+  # Safety: never allow internal drives even if explicitly passed
   if is_internal "$TARGET"; then
     fail "Target '$TARGET' is an internal system drive and cannot be used for external backup."
   fi
@@ -377,259 +193,129 @@ else
   log "Auto-detecting external USB drives…"
   TARGET="$(find_external_drive)"
   if [[ -z "$TARGET" ]]; then
-    fail "No external USB drive detected. Please plug in an ext4-formatted USB drive and try again."
+    fail "No external USB drive detected. " \
+         "Please plug in an exFAT-formatted USB drive (≥500 GB) and try again."
   fi
   log "Detected external drive: $TARGET"
 fi
 
-validate_target_mount "$TARGET"
+# ── Verify mount point ───────────────────────────────────────────
 
-# ── Set up stable backup destination ────────────────────────────
-# Subsequent runs update the same mirror, transferring only new or changed files.
+[[ -d "$TARGET" ]] || fail "Target path '$TARGET' does not exist."
+mountpoint -q "$TARGET" || fail "Target path '$TARGET' is not a mount point."
 
-BACKUP_DIR="${TARGET}/${BACKUP_SUBPATH}"
-mkdir -p -- "$BACKUP_DIR"
+# ── Check free disk space (require ≥ 10 GB) ──────────────────────
 
-# Remove any stale BACKUP_COMPLETE left by a previous successful run.
-# The new run will re-earn it only after all stages succeed.
-rm -f "$BACKUP_DIR/BACKUP_COMPLETE"
+FREE_KB=$(df -k --output=avail "$TARGET" | tail -1)
+FREE_GB=$(( FREE_KB / 1024 / 1024 ))
+log "Free space on drive: ${FREE_GB} GB"
+(( FREE_GB >= MIN_FREE_GB )) || \
+  fail "Not enough free space on drive (${FREE_GB} GB available, ${MIN_FREE_GB} GB required)."
 
-# Write an INCOMPLETE marker immediately; replaced by BACKUP_COMPLETE only
-# after all rsync stages and manifest write succeed. Failed or interrupted
-# runs keep this marker so they are clearly identifiable.
-touch "$BACKUP_DIR/INCOMPLETE"
+# ── Create timestamped backup directory ─────────────────────────
+
+TIMESTAMP="$(date '+%Y%m%d_%H%M%S')"
+BACKUP_DIR="${TARGET}/Sovran_SystemsOS_Backup/${TIMESTAMP}"
+mkdir -p "$BACKUP_DIR"
 log "Backup destination: $BACKUP_DIR"
 
-# ── Estimate required free space ─────────────────────────────────
-# PostgreSQL/MariaDB raw directories and Bitcoin/Electrs data are excluded
-# from the estimate to avoid inflating the required size.
-
-ETC_NIXOS_BYTES=$(estimate_path_bytes /etc/nixos)
-HOME_BYTES=$(estimate_path_bytes /home --exclude='*/.cache' --exclude='*/.local/share/Trash' --exclude='*/Trash')
-
-# nix-bitcoin secrets and /var/lib system service data exist only on the
-# Node and Server + Desktop roles — they are skipped entirely on Desktop Only.
-SECRETS_BYTES=0
-VAR_LIB_BYTES=0
-if [[ "$ROLE" != "desktop" ]]; then
-  SECRETS_BYTES=$(estimate_path_bytes /etc/nix-bitcoin-secrets)
-  VAR_LIB_BYTES=$(estimate_path_bytes /var/lib \
-    --exclude='postgresql' \
-    --exclude='mysql' \
-    --exclude='mariadb' \
-    --exclude='bitcoind' \
-    --exclude='electrs' \
-    --exclude='*/log' \
-    --exclude='*/logs' \
-    --exclude='*/cache' \
-    --exclude='*/tmp')
-fi
-
-ESTIMATED_BYTES=$(( ETC_NIXOS_BYTES + HOME_BYTES + SECRETS_BYTES + VAR_LIB_BYTES ))
-# Require 20% growth headroom plus a fixed 1 GiB safety margin.
-# Later incremental runs need far less space, but a conservative first-run
-# check protects against running out of space mid-backup.
-REQUIRED_BYTES=$(( ESTIMATED_BYTES + (ESTIMATED_BYTES / 5) + SAFETY_MARGIN_BYTES ))
-
-FREE_BYTES=$(df -B1 --output=avail "$TARGET" | tail -1 | tr -d ' ')
-FREE_GB=$(( FREE_BYTES / 1024 / 1024 / 1024 ))
-REQUIRED_GB=$(( REQUIRED_BYTES / 1024 / 1024 / 1024 ))
-
-log "Estimated backup size: $(( ESTIMATED_BYTES / 1024 / 1024 / 1024 )) GB"
-log "Required free space (with safety margin): ${REQUIRED_GB} GB"
-log "Free space on drive: ${FREE_GB} GB"
-
-(( FREE_BYTES >= REQUIRED_BYTES )) || \
-  fail "Not enough free space on drive (${FREE_GB} GB available, ${REQUIRED_GB} GB required)."
-
-# ── Stage 1: NixOS configuration ────────────────────────────────
+# ── Stage 1/4: NixOS configuration ──────────────────────────────
 
 log ""
-log "── Stage 1/${TOTAL_STAGES}: NixOS configuration (/etc/nixos) ──────────────"
+log "── Stage 1/4: NixOS configuration (/etc/nixos) ──────────────"
 if [[ -d /etc/nixos ]]; then
-  sync_tree "/etc/nixos" no /etc/nixos/ "$BACKUP_DIR/etc/nixos/"
+  rsync -a --info=progress2 /etc/nixos/ "$BACKUP_DIR/nixos/" 2>&1 | tee -a "$BACKUP_LOG" || \
+    fail "Stage 1 failed while copying /etc/nixos"
   log "Stage 1 complete."
 else
   log "WARNING: /etc/nixos not found — skipping."
 fi
 
-# ── Stage 2: Secrets ────────────────────────────────────────────
-# Only applies to the Node and Server + Desktop roles. Desktop Only systems
-# run no nix-bitcoin services, so there are no secrets to back up and this
-# stage does not exist for them.
-
-if [[ "$ROLE" != "desktop" ]]; then
-  log ""
-  log "── Stage 2/${TOTAL_STAGES}: Secrets (/etc/nix-bitcoin-secrets) ───────────"
-  if [[ -e /etc/nix-bitcoin-secrets ]]; then
-    sync_tree "/etc/nix-bitcoin-secrets" no /etc/nix-bitcoin-secrets/ "$BACKUP_DIR/etc/nix-bitcoin-secrets/"
-  else
-    log "(not found: /etc/nix-bitcoin-secrets — skipping)"
-  fi
-  log "Stage 2 complete."
-fi
-
-# ── Home directory ──────────────────────────────────────────────
-# Stage 2/2 on Desktop Only, stage 3/4 on Node and Server + Desktop.
-# Rsync exit code 24 (vanished source files) is treated as nonfatal here
-# because the desktop may be active and files can disappear between the
-# directory scan and the copy. All other nonzero exit codes remain fatal.
+# ── Stage 2/4: Secrets ──────────────────────────────────────────
 
 log ""
-log "── Stage ${HOME_STAGE_NUM}/${TOTAL_STAGES}: Home directory (/home) ───────────────────────"
+log "── Stage 2/4: Secrets ───────────────────────────────────────"
+mkdir -p "$BACKUP_DIR/secrets"
+
+if [[ "$ROLE" == "desktop" ]]; then
+  log "Skipping /etc/nix-bitcoin-secrets — not applicable for Desktop Only role."
+else
+  if [[ -e /etc/nix-bitcoin-secrets ]]; then
+    rsync -a --info=progress2 /etc/nix-bitcoin-secrets "$BACKUP_DIR/secrets/" 2>&1 | tee -a "$BACKUP_LOG" || \
+      log "WARNING: Could not copy /etc/nix-bitcoin-secrets — continuing."
+  else
+    log "  (not found: /etc/nix-bitcoin-secrets — skipping)"
+  fi
+fi
+
+log "Stage 2 complete."
+
+# ── Stage 3/4: Home directory ────────────────────────────────────
+
+log ""
+log "── Stage 3/4: Home directory (/home) ───────────────────────"
 if [[ -d /home ]]; then
-  sync_tree "/home" yes /home/ "$BACKUP_DIR/home/" \
+  rsync -a --info=progress2 \
     --exclude='.cache/' \
     --exclude='.local/share/Trash/' \
-    --exclude='Trash/' \
-    --exclude='.mozilla/firefox/*/cache2/' \
-    --exclude='.mozilla/firefox/*/startupCache/' \
-    --exclude='.mozilla/firefox/*/thumbnails/' \
-    --exclude='.config/google-chrome/*/Cache/' \
-    --exclude='.config/google-chrome/*/Code Cache/' \
-    --exclude='.config/chromium/*/Cache/' \
-    --exclude='.config/chromium/*/Code Cache/' \
-    --exclude='.config/BraveSoftware/Brave-Browser/*/Cache/' \
-    --exclude='.config/BraveSoftware/Brave-Browser/*/Code Cache/' \
-    --exclude='.local/share/baloo/' \
-    --exclude='.thumbnails/' \
-    --exclude='.xsession-errors' \
-    --exclude='.xsession-errors.old'
-  log "Stage ${HOME_STAGE_NUM} complete."
+    --exclude='*/Trash/' \
+    /home/ "$BACKUP_DIR/home/" 2>&1 | tee -a "$BACKUP_LOG" || \
+    fail "Stage 3 failed while copying /home"
+  log "Stage 3 complete."
 else
   log "WARNING: /home not found — skipping."
 fi
 
-# ── Stage 4: System data ────────────────────────────────────────
-# Only applies to the Node and Server + Desktop roles — Desktop Only systems
-# run no server services, so /var/lib holds no service data worth mirroring.
-# PostgreSQL/MariaDB raw database directories are excluded. Application
-# databases must be backed up separately with native database tools.
-# Bitcoin/Electrs data are excluded; they live on the internal second drive.
+# ── Stage 4/4: System data ───────────────────────────────────────
 
-if [[ "$ROLE" != "desktop" ]]; then
-  log ""
-  log "── Stage 4/${TOTAL_STAGES}: System data (/var/lib) ───────────────────────"
+log ""
+log "── Stage 4/4: System data (/var/lib) ────────────────────────"
+if [[ "$ROLE" == "desktop" ]]; then
   if [[ -d /var/lib ]]; then
-    sync_tree "/var/lib" no /var/lib/ "$BACKUP_DIR/var/lib/" \
-      --exclude='postgresql/' \
-      --exclude='mysql/' \
-      --exclude='mariadb/' \
-      --exclude='bitcoind/' \
-      --exclude='electrs/' \
-      --exclude='*/log/' \
+    rsync -a --info=progress2 \
+      --filter='- /lnd/***' \
+      --exclude='logs/' \
+      --exclude='log/' \
       --exclude='*/logs/' \
-      --exclude='*/cache/' \
-      --exclude='*/tmp/'
-    log "Stage 4 complete."
+      --exclude='*/log/' \
+      /var/lib/ "$BACKUP_DIR/var-lib/" 2>&1 | tee -a "$BACKUP_LOG" || \
+      fail "Stage 4 failed while copying /var/lib for Desktop Only role"
+    log "Stage 4 complete (Desktop Only role excludes /var/lib/lnd)."
   else
     log "WARNING: /var/lib not found — skipping."
   fi
+elif [[ -d /var/lib ]]; then
+  rsync -a --info=progress2 \
+    --exclude='logs/' \
+    --exclude='log/' \
+    --exclude='*/logs/' \
+    --exclude='*/log/' \
+    /var/lib/ "$BACKUP_DIR/var-lib/" 2>&1 | tee -a "$BACKUP_LOG" || \
+    fail "Stage 4 failed while copying /var/lib"
+  log "Stage 4 complete."
+else
+  log "WARNING: /var/lib not found — skipping."
 fi
 
 # ── Generate manifest ────────────────────────────────────────────
 
 log ""
 log "Generating BACKUP_MANIFEST.txt …"
-MANIFEST_FILE="$BACKUP_DIR/BACKUP_MANIFEST.txt"
-
 {
   echo "Sovran_SystemsOS Backup Manifest"
-  echo "Updated:   $(date -u '+%Y-%m-%dT%H:%M:%SZ')"
+  echo "Generated: $(date)"
   echo "Hostname:  $(hostname)"
   echo "Role:      $ROLE_LABEL"
   echo "Target:    $TARGET"
   echo ""
-  echo "Backup type: Live rsync mirror (directly browsable files)"
-  echo "Location:    ${BACKUP_DIR}"
-  echo ""
-  echo "Source paths mirrored:"
-  echo "- /etc/nixos  →  current/etc/nixos/"
-  if [[ "$ROLE" != "desktop" ]]; then
-    echo "- /etc/nix-bitcoin-secrets (when present)  →  current/etc/nix-bitcoin-secrets/"
-  fi
-  echo "- /home  →  current/home/"
-  if [[ "$ROLE" != "desktop" ]]; then
-    echo "- /var/lib  →  current/var/lib/"
-  fi
-  echo ""
-  echo "Exclusions:"
-  if [[ "$ROLE" != "desktop" ]]; then
-    echo "- /var/lib/postgresql (PostgreSQL raw database files — not included)"
-    echo "- /var/lib/mysql, /var/lib/mariadb (MariaDB raw database files — not included)"
-    echo "- /var/lib/bitcoind (Bitcoin blockchain — excluded; lives on internal second drive)"
-    echo "- /var/lib/electrs (Electrs index — excluded; lives on internal second drive)"
-    echo "- /run/media/Second_Drive (internal second drive — never traversed)"
-    echo "- /var/lib/*/log, /var/lib/*/logs, /var/lib/*/cache, /var/lib/*/tmp"
-  fi
-  echo "- Browser disk caches, thumbnail caches, trash directories, X session error logs"
-  echo ""
-  echo "Important limitations:"
-  if [[ "$ROLE" != "desktop" ]]; then
-    echo "- PostgreSQL and MariaDB/MySQL application databases are NOT included in this"
-    echo "  backup. If you use Nextcloud, Matrix/Synapse, or other database-backed"
-    echo "  applications, their data must be backed up separately using native tools."
-    echo "- Bitcoin blockchain data and Electrs indexes are NOT included; they are"
-    echo "  reconstructable or stored on the internal second drive."
-  fi
-  echo "- This is a live file-level mirror, not a transactional database backup."
-  echo "  Files being written during the backup may be in an inconsistent state."
-  echo ""
-  echo "Restore guidance:"
-  echo "- Files are directly browsable on the backup drive under: ${BACKUP_DIR}"
-  echo "- To restore a directory:"
-  echo "    sudo rsync -aAXH --numeric-ids current/etc/nixos/ /etc/nixos/"
-  echo "    sudo rsync -aAXH --numeric-ids current/home/ /home/"
-  if [[ "$ROLE" != "desktop" ]]; then
-    echo "    sudo rsync -aAXH --numeric-ids current/var/lib/ /var/lib/"
-  fi
-  echo "- To copy individual files:"
-  echo "    sudo cp -a current/home/username/ /home/username/"
-  echo "- When restoring /etc/nixos to replacement hardware, regenerate"
-  echo "  hardware-configuration.nix for the new hardware before rebuilding."
-  echo ""
-  echo "Nonfatal warnings:"
-  if [[ "${#RSYNC_WARNINGS[@]}" -eq 0 ]]; then
-    echo "- none"
-  else
-    for warning in "${RSYNC_WARNINGS[@]}"; do
-      echo "- $warning"
-    done
-  fi
-  if [[ "$ROLE" != "desktop" ]]; then
-    echo ""
-    echo "Note: Bitcoin blockchain and Electrs index data are intentionally excluded"
-    echo "from manual external backup because they already live on the internal second drive"
-    echo "(/run/media/Second_Drive) and are reconstructable/internal-backup data."
-  fi
-} > "$MANIFEST_FILE"
-
-log "Manifest written to $MANIFEST_FILE"
+  echo "Contents:"
+  find "$BACKUP_DIR" -mindepth 1 -maxdepth 2 | sort
+} > "$BACKUP_DIR/BACKUP_MANIFEST.txt"
+log "Manifest written to $BACKUP_DIR/BACKUP_MANIFEST.txt"
 
 # ── Done ─────────────────────────────────────────────────────────
 
 log ""
-if [[ "${#RSYNC_WARNINGS[@]}" -gt 0 ]]; then
-  log "Backup completed with nonfatal warnings:"
-  for warning in "${RSYNC_WARNINGS[@]}"; do
-    log "  WARNING: $warning"
-  done
-  log "Your important data is backed up. The warnings above indicate files that"
-  log "vanished during backup, which is normal on an active desktop."
-  log ""
-fi
-if [[ "$ROLE" == "desktop" ]]; then
-  log "All Finished! Your data is now backed up to a second, external location."
-else
-  log "All Finished! Your data is now backed up to a third location."
-fi
-log "Files are directly browsable on the drive under: ${BACKUP_DIR}"
+log "All Finished! Your data is now backed up to a third location."
 log "Please eject the drive safely before removing it from your Sovran Pro."
-
-# Remove incomplete marker and write completion marker only after all work succeeds.
-# A later successful run will update the same mirror and replace any INCOMPLETE state.
-rm -f "$BACKUP_DIR/INCOMPLETE"
-date -u '+%Y-%m-%dT%H:%M:%SZ' > "$BACKUP_DIR/BACKUP_COMPLETE"
-
-BACKUP_COMPLETE=1
 set_status "SUCCESS"

app/sovran_systemsos_web/static/css/domain-setup.css

@@ -171,67 +171,3 @@ domain-field-actions {
 .port-req-status {
   font-weight: 600;
 }
-
-/* ── Port-forwarding instructions ─────────────────────────────────── */
-
-.port-req-steps {
-  margin: 4px 0 12px;
-  padding-left: 20px;
-  font-size: 0.84rem;
-  color: var(--text-secondary);
-  line-height: 1.65;
-}
-
-.port-req-steps li {
-  margin-bottom: 5px;
-}
-
-.port-proto-badge {
-  display: inline-block;
-  font-family: 'JetBrains Mono', 'Fira Code', 'Source Code Pro', monospace;
-  font-size: 0.72rem;
-  font-weight: 700;
-  letter-spacing: 0.04em;
-  padding: 2px 7px;
-  border-radius: 5px;
-  white-space: nowrap;
-}
-
-.port-proto-badge--tcp {
-  color: #6dbf8b;
-  background: rgba(109, 191, 139, 0.12);
-  border: 1px solid rgba(109, 191, 139, 0.4);
-}
-
-.port-proto-badge--udp {
-  color: #6aa9e0;
-  background: rgba(106, 169, 224, 0.12);
-  border: 1px solid rgba(106, 169, 224, 0.4);
-}
-
-.port-proto-badge--both {
-  color: #e5a50a;
-  background: rgba(229, 165, 10, 0.12);
-  border: 1px solid rgba(229, 165, 10, 0.45);
-}
-
-.port-proto-note {
-  display: block;
-  margin-top: 3px;
-  font-size: 0.68rem;
-  color: var(--text-dim);
-  text-transform: none;
-  letter-spacing: 0;
-}
-
-/* ── Wallet Connections unique-hostname warning ───────────────────── */
-
-.domain-nwc-warning {
-  margin-bottom: 14px;
-  padding: 10px 14px;
-  background: rgba(255, 180, 0, 0.10);
-  border: 1px solid var(--warning-color, #f59e0b);
-  border-radius: 8px;
-  font-size: 0.88rem;
-  line-height: 1.6;
-}

app/sovran_systemsos_web/static/css/header.css

@@ -29,15 +29,6 @@
   color: var(--text-primary);
 }
 
-.title-group {
-  display: flex;
-  flex-direction: row;
-  flex-wrap: wrap;
-  align-items: center;
-  justify-content: center;
-  gap: 6px 10px;
-}
-
 .header-buttons {
   display: flex;
   align-items: center;
@@ -54,23 +45,6 @@
   letter-spacing: 0.03em;
 }
 
-/* ── OS Version Badge — identical styling to the version badge ────
-   ── shown next to titles in the service modal windows ──────────── */
-.os-version-badge {
-  background-color: rgba(255, 255, 255, 0.06);
-  color: var(--text-secondary);
-  font-size: 0.72rem;
-  font-weight: 600;
-  padding: 2px 10px;
-  border-radius: 12px;
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  letter-spacing: 0.02em;
-  display: inline-flex;
-  align-items: center;
-  white-space: nowrap;
-  flex-shrink: 0;
-}
-
 /* ── IP bar ─────────────────────────────────────────────────────── */
 
 .ip-bar {
@@ -117,30 +91,3 @@
   border-color: var(--accent-color);
   color: var(--accent-color);
 }
-
-/* ── Header reboot button ───────────────────────────────────────── */
-
-.btn-header-reboot {
-  background: transparent;
-  border: 1px solid rgba(184, 125, 0, 0.35);
-  color: #c98d08;
-  font-size: 0.78rem;
-  font-weight: 600;
-  padding: 4px 12px;
-  border-radius: var(--radius-btn);
-  cursor: pointer;
-  transition: border-color 0.15s, color 0.15s, background-color 0.15s;
-}
-
-.btn-header-reboot:hover {
-  border-color: #b87d00;
-  color: #e0a010;
-  background-color: rgba(184, 125, 0, 0.1);
-}
-
-@media (max-width: 480px) {
-  .btn-header-reboot {
-    padding: 4px 8px;
-    font-size: 0.72rem;
-  }
-}

app/sovran_systemsos_web/static/css/modals.css

@@ -1,56 +1,5 @@
-/* ── NWC Benefits Grid ─────────────────────────────────────────── */
-
-.nwc-benefits-grid {
-  display: grid;
-  grid-template-columns: repeat(3, 1fr);
-  gap: 12px;
-  margin-top: 14px;
-}
-
-.nwc-benefit-item {
-  background: rgba(255, 255, 255, 0.02);
-  border: 1px solid var(--border-color);
-  border-radius: 10px;
-  padding: 10px 14px;
-  display: flex;
-  gap: 12px;
-  align-items: flex-start;
-  transition: background-color 0.2s;
-}
-
-.nwc-benefit-item:hover {
-  background: rgba(255, 255, 255, 0.04);
-}
-
-.nwc-benefit-icon {
-  font-size: 1.25rem;
-  margin-top: 2px;
-  opacity: 0.9;
-}
-
-.nwc-benefit-content strong {
-  display: block;
-  font-size: 0.82rem;
-  color: var(--text-primary);
-  margin-bottom: 2px;
-}
-
-.nwc-benefit-content p {
-  margin: 0;
-  font-size: 0.75rem;
-  line-height: 1.45;
-  color: var(--text-secondary);
-}
-
-@media (max-width: 800px) {
-  .nwc-benefits-grid {
-    grid-template-columns: 1fr;
-  }
-}
-
 /* ── Update modal ────────────────────────────────────────────────── */
 
-
 .modal-overlay {
   display: none;
   position: fixed;
@@ -153,48 +102,6 @@ button.btn-reboot:hover:not(:disabled) {
   background-color: #529E7E;
 }
 
-/* Restart = AMBER (manual restart action) */
-.btn-restart-amber {
-  background-color: #b87d00;
-  color: #fff;
-}
-
-.btn-restart-amber:hover:not(:disabled) {
-  background-color: #9a6800;
-}
-
-/* Restart conflict warning box */
-.restart-conflict-box {
-  background-color: rgba(180, 100, 0, 0.12);
-  border-left: 3px solid #c97a00;
-  border-radius: 6px;
-  padding: 12px 14px;
-  margin-bottom: 14px;
-}
-
-.restart-conflict-title {
-  font-size: 0.88rem;
-  font-weight: 700;
-  color: #e69000;
-  margin: 0 0 6px 0;
-}
-
-.restart-conflict-desc {
-  font-size: 0.83rem;
-  color: var(--text-secondary);
-  line-height: 1.5;
-  margin: 0;
-}
-
-/* Reboot error card actions row */
-.reboot-error-actions {
-  display: flex;
-  gap: 12px;
-  justify-content: center;
-  flex-wrap: wrap;
-  margin-top: 20px;
-}
-
 .btn-save {
   background-color: var(--yellow);
   color: #0A1A10;
@@ -251,19 +158,6 @@ button.btn-reboot:hover:not(:disabled) {
   gap: 10px;
 }
 
-.creds-title-version-badge {
-  background-color: rgba(255, 255, 255, 0.06);
-  color: var(--text-secondary);
-  font-size: 0.72rem;
-  font-weight: 600;
-  padding: 2px 10px;
-  border-radius: 12px;
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  letter-spacing: 0.02em;
-  display: inline-flex;
-  align-items: center;
-}
-
 .creds-title-icon {
   width: 28px;
   height: 28px;
@@ -287,10 +181,6 @@ button.btn-reboot:hover:not(:disabled) {
   color: var(--text-primary);
 }
 
-.creds-dialog--wide {
-  max-width: 980px;
-}
-
 .creds-body {
   padding: 24px 28px;
   overflow-y: auto;
@@ -546,593 +436,3 @@ button.btn-reboot:hover:not(:disabled) {
   color: var(--text-secondary);
   font-style: italic;
 }
-
-.nwc-secret-warning {
-  margin: 0 0 14px;
-  padding: 10px 12px;
-  border-radius: 8px;
-  border: 1px solid #f59e0b;
-  background: rgba(245, 158, 11, 0.12);
-  color: #fbbf24;
-  font-size: 0.86rem;
-}
-
-/* ── Lightning Wallet Connections: tabbed shell ─────────────────── */
-
-.nwc-tabs-bar {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  flex-wrap: wrap;
-  gap: 12px;
-  margin: -6px 0 20px;
-  padding-bottom: 12px;
-  border-bottom: 1px solid var(--border-color);
-}
-
-.nwc-tabs-btns {
-  display: flex;
-  gap: 4px;
-  background: rgba(255, 255, 255, 0.03);
-  border: 1px solid var(--border-color);
-  border-radius: 10px;
-  padding: 4px;
-}
-
-.nwc-tab-btn {
-  background: none;
-  border: none;
-  color: var(--text-secondary);
-  font-size: 0.86rem;
-  font-weight: 600;
-  padding: 8px 16px;
-  border-radius: 7px;
-  cursor: pointer;
-  white-space: nowrap;
-  transition: background-color 0.15s ease, color 0.15s ease;
-}
-
-.nwc-tab-btn:hover:not(.active) {
-  color: var(--text-primary);
-  background: rgba(255, 255, 255, 0.04);
-}
-
-.nwc-tab-btn.active {
-  background: var(--accent-color);
-  color: #0A1A10;
-}
-
-.nwc-header-chips {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  flex-wrap: wrap;
-}
-
-.nwc-header-chip {
-  display: inline-flex;
-  align-items: center;
-  gap: 6px;
-  font-size: 0.75rem;
-  color: var(--text-secondary);
-  background: rgba(255, 255, 255, 0.03);
-  border: 1px solid var(--border-color);
-  border-radius: 999px;
-  padding: 4px 10px;
-  max-width: 260px;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.nwc-header-chip--domain {
-  font-family: 'JetBrains Mono', 'Fira Code', 'Source Code Pro', monospace;
-  font-size: 0.72rem;
-}
-
-.nwc-header-chip--warn {
-  border-color: rgba(245, 158, 11, 0.5);
-  color: #fbbf24;
-}
-
-.nwc-tab-panel {
-  display: none;
-}
-
-.nwc-tab-panel.active {
-  display: block;
-  animation: nwc-tab-fade 0.16s ease-out;
-}
-
-@keyframes nwc-tab-fade {
-  from { opacity: 0; transform: translateY(4px); }
-  to   { opacity: 1; transform: translateY(0); }
-}
-
-/* Setup tab: first section shouldn't double up on top padding */
-#nwc-tab-setup .svc-detail-section:first-child {
-  padding-top: 0;
-  margin-top: 0;
-  border-top: none;
-}
-
-.nwc-tab-intro {
-  display: flex;
-  flex-direction: column;
-  align-items: stretch;
-  gap: 16px;
-  margin-bottom: 20px;
-  padding-bottom: 20px;
-  border-bottom: 1px solid var(--border-color);
-}
-
-.nwc-tab-intro-title {
-  font-size: 1rem;
-  font-weight: 700;
-  color: var(--text-primary);
-  margin-bottom: 4px;
-}
-
-.nwc-tab-intro-desc {
-  margin: 0;
-  font-size: 0.85rem;
-  line-height: 1.5;
-  color: var(--text-secondary);
-  max-width: 62ch;
-}
-
-/* ── Wallet toolbar ─────────────────────────────────────────────── */
-
-.nwc-toolbar {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 12px;
-  flex-wrap: wrap;
-  margin-bottom: 14px;
-}
-
-.nwc-toolbar-count {
-  font-size: 0.78rem;
-  font-weight: 700;
-  text-transform: uppercase;
-  letter-spacing: 0.06em;
-  color: var(--text-dim);
-}
-
-.nwc-toolbar-actions {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-}
-
-.nwc-toolbar-actions .matrix-action-btn,
-.nwc-toolbar-actions .matrix-form-back {
-  padding: 8px 14px;
-  font-size: 0.82rem;
-}
-
-/* ── Domain-required callout ────────────────────────────────────── */
-
-.nwc-domain-required {
-  border: 1px solid rgba(245, 158, 11, 0.4);
-  background: rgba(245, 158, 11, 0.08);
-  border-radius: 10px;
-  padding: 14px 16px;
-  margin-bottom: 16px;
-  font-size: 0.86rem;
-  color: var(--text-primary);
-}
-
-.nwc-domain-required-body {
-  margin-top: 6px;
-  color: var(--text-secondary);
-  line-height: 1.5;
-}
-
-.nwc-domain-required-btn {
-  margin-top: 12px;
-}
-
-/* ── Empty / disabled states ────────────────────────────────────── */
-
-.nwc-empty-state,
-.nwc-disabled-state {
-  text-align: center;
-  padding: 36px 24px;
-  border: 1px dashed var(--border-color);
-  border-radius: 12px;
-  background: rgba(255, 255, 255, 0.015);
-}
-
-.nwc-empty-icon,
-.nwc-disabled-icon {
-  font-size: 2rem;
-  margin-bottom: 10px;
-}
-
-.nwc-empty-title,
-.nwc-disabled-title {
-  font-size: 1rem;
-  font-weight: 700;
-  color: var(--text-primary);
-  margin-bottom: 6px;
-}
-
-.nwc-empty-desc,
-.nwc-disabled-desc {
-  margin: 0 auto 14px;
-  max-width: 46ch;
-  font-size: 0.86rem;
-  line-height: 1.55;
-  color: var(--text-secondary);
-}
-
-/* ── Wallet cards ───────────────────────────────────────────────── */
-
-.nwc-wallet-list {
-  display: grid;
-  grid-template-columns: repeat(auto-fill, minmax(340px, 1fr));
-  gap: 12px;
-  margin-top: 12px;
-}
-
-.nwc-wallet-card {
-  border: 1px solid var(--border-color);
-  border-radius: 12px;
-  padding: 14px 16px;
-  background: rgba(255, 255, 255, 0.02);
-  display: flex;
-  flex-direction: column;
-  transition: border-color 0.15s ease;
-}
-
-.nwc-wallet-card:hover {
-  border-color: rgba(255, 255, 255, 0.16);
-}
-
-.nwc-wallet-card-head {
-  display: flex;
-  align-items: flex-start;
-  justify-content: space-between;
-  gap: 10px;
-  margin-bottom: 12px;
-}
-
-.nwc-wallet-card-title {
-  font-weight: 700;
-  font-size: 0.95rem;
-  color: var(--text-primary);
-  word-break: break-word;
-}
-
-.nwc-wallet-chips {
-  display: flex;
-  gap: 6px;
-  flex-wrap: wrap;
-  justify-content: flex-end;
-  flex-shrink: 0;
-}
-
-.nwc-wallet-chip {
-  display: inline-flex;
-  align-items: center;
-  font-size: 0.72rem;
-  font-weight: 700;
-  border-radius: 999px;
-  padding: 4px 10px;
-  white-space: nowrap;
-}
-
-.nwc-wallet-chip--balance {
-  background: rgba(109, 191, 139, 0.14);
-  color: var(--green);
-  font-family: 'JetBrains Mono', 'Fira Code', 'Source Code Pro', monospace;
-}
-
-.nwc-wallet-chip--pending {
-  background: rgba(245, 158, 11, 0.14);
-  color: #fbbf24;
-}
-
-.nwc-wallet-address {
-  margin-bottom: 4px;
-}
-
-.nwc-wallet-address .creds-value {
-  font-size: 0.82rem;
-  padding: 9px 12px;
-}
-
-.nwc-wallet-address .creds-copy-btn {
-  margin-top: 5px;
-  padding: 7px 12px;
-}
-
-.nwc-wallet-actions {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  flex-wrap: wrap;
-  margin-top: 12px;
-  padding-top: 12px;
-  border-top: 1px solid var(--border-color);
-}
-
-.nwc-wallet-actions-spacer {
-  flex: 1;
-  min-width: 0;
-}
-
-.nwc-wallet-actions .matrix-form-back,
-.nwc-wallet-actions .btn-close-modal,
-.nwc-wallet-actions .matrix-action-btn {
-  padding: 7px 12px;
-  font-size: 0.8rem;
-}
-
-.nwc-wallet-danger-btn {
-  color: #f08a8a;
-}
-
-.nwc-wallet-danger-btn:hover:not(:disabled) {
-  background-color: rgba(220, 80, 80, 0.14);
-  color: #ff9d9d;
-}
-
-/* ── NWC LNURL share / download view ───────────────────────────── */
-
-.nwc-share-actions {
-  display: flex;
-  gap: 8px;
-  flex-wrap: wrap;
-  margin-top: 14px;
-}
-
-.nwc-share-actions .matrix-form-back,
-.nwc-share-actions .matrix-form-submit {
-  padding: 8px 12px;
-  font-size: 0.82rem;
-}
-
-.nwc-lnurl-value {
-  font-size: 0.72rem;
-  word-break: break-all;
-}
-
-.nwc-share-formats-hint {
-  text-align: center;
-}
-
-/* ── NWC Liquidity Guide (collapsible) ──────────────────────────── */
-
-.nwc-liquidity-details {
-  margin-top: 20px;
-  border: 1px solid var(--border-color);
-  border-radius: 12px;
-  background: rgba(255, 255, 255, 0.015);
-}
-
-.nwc-liquidity-summary {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-  padding: 14px 16px;
-  cursor: pointer;
-  list-style: none;
-  color: var(--text-primary);
-  font-size: 0.9rem;
-}
-
-.nwc-liquidity-summary::-webkit-details-marker {
-  display: none;
-}
-
-.nwc-liquidity-summary::after {
-  content: "▸";
-  margin-left: auto;
-  color: var(--text-dim);
-  transition: transform 0.15s ease;
-}
-
-.nwc-liquidity-details[open] .nwc-liquidity-summary::after {
-  transform: rotate(90deg);
-}
-
-.nwc-liquidity-summary:hover {
-  background: rgba(255, 255, 255, 0.02);
-  border-radius: 12px;
-}
-
-.nwc-liquidity-icon {
-  font-size: 22px;
-}
-
-.nwc-liquidity-subtitle {
-  display: block;
-  margin-top: 2px;
-  font-size: 0.75rem;
-  font-weight: 400;
-  color: var(--text-secondary);
-}
-
-.nwc-liquidity-guide-card {
-  padding: 0 16px 16px;
-  color: var(--text-primary);
-}
-
-.nwc-liquidity-body {
-  font-size: 0.82rem;
-  line-height: 1.55;
-  margin: 0 0 12px;
-  color: var(--text-secondary);
-}
-
-.nwc-liquidity-steps {
-  display: flex;
-  flex-direction: column;
-  gap: 10px;
-  margin-bottom: 14px;
-}
-
-.nwc-liquidity-step {
-  display: flex;
-  gap: 10px;
-  align-items: flex-start;
-  font-size: 0.85rem;
-}
-
-.nwc-liquidity-step-desc {
-  margin: 2px 0 0;
-  color: var(--text-secondary);
-  font-size: 0.78rem;
-  line-height: 1.5;
-}
-
-.step-num {
-  background: var(--accent-color);
-  color: #0A1A10;
-  width: 20px;
-  height: 20px;
-  border-radius: 50%;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-weight: 700;
-  font-size: 0.75rem;
-  flex-shrink: 0;
-  margin-top: 1px;
-}
-
-.nwc-liquidity-action {
-  background: rgba(109, 191, 139, 0.08);
-  border-left: 3px solid var(--green);
-  padding: 10px 12px;
-  border-radius: 0 8px 8px 0;
-  font-size: 0.82rem;
-}
-
-.nwc-liquidity-analogy {
-  margin: 0 0 10px;
-  font-size: 0.8rem;
-  line-height: 1.45;
-}
-
-.nwc-rtl-btn {
-  display: inline-flex;
-  align-items: center;
-  gap: 6px;
-  background: var(--border-color);
-  color: var(--text-primary);
-  border: none;
-  padding: 8px 14px;
-  border-radius: 8px;
-  font-size: 0.8rem;
-  cursor: pointer;
-}
-
-.nwc-rtl-btn:hover {
-  background: #1c2a24;
-}
-
-/* ── NWC Connect Guide (shown after wallet creation) ────────────── */
-
-.nwc-connect-guide {
-  margin-top: 16px;
-  padding: 16px;
-  border: 1px solid var(--border-color);
-  border-radius: 12px;
-  background: rgba(109, 191, 139, 0.04);
-}
-
-.nwc-connect-guide-title {
-  font-size: 1rem;
-  font-weight: 700;
-  color: var(--text-primary);
-  margin-bottom: 8px;
-}
-
-.nwc-connect-guide-intro {
-  margin: 0 0 14px;
-  font-size: 0.85rem;
-  line-height: 1.55;
-  color: var(--text-secondary);
-}
-
-.nwc-connect-steps {
-  display: flex;
-  flex-direction: column;
-  gap: 10px;
-  margin-bottom: 14px;
-}
-
-.nwc-connect-step {
-  display: flex;
-  gap: 10px;
-  align-items: flex-start;
-  font-size: 0.86rem;
-  line-height: 1.5;
-}
-
-.nwc-step-num {
-  background: var(--accent-color);
-  color: #0A1A10;
-  width: 22px;
-  height: 22px;
-  border-radius: 50%;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-weight: 700;
-  font-size: 0.78rem;
-  flex-shrink: 0;
-  margin-top: 2px;
-}
-
-.nwc-connect-note {
-  background: rgba(245, 158, 11, 0.08);
-  border-left: 3px solid #f59e0b;
-  padding: 10px 12px;
-  border-radius: 0 8px 8px 0;
-  font-size: 0.8rem;
-  line-height: 1.5;
-  color: var(--text-secondary);
-}
-
-.nwc-connect-note strong {
-  color: #fbbf24;
-}
-
-/* ── Narrow screens ─────────────────────────────────────────────── */
-
-@media (max-width: 720px) {
-  .nwc-tabs-bar {
-    align-items: stretch;
-    flex-direction: column;
-  }
-
-  .nwc-tabs-btns {
-    justify-content: stretch;
-  }
-
-  .nwc-tab-btn {
-    flex: 1;
-    padding: 8px 10px;
-  }
-
-  .nwc-wallet-list {
-    grid-template-columns: 1fr;
-  }
-
-  .nwc-wallet-card-head {
-    flex-direction: column;
-  }
-
-  .nwc-wallet-chips {
-    justify-content: flex-start;
-  }
-
-  .nwc-wallet-actions-spacer {
-    display: none;
-  }
-}

app/sovran_systemsos_web/static/js/domain-prereqs.js

@@ -1,146 +0,0 @@
-/* Sovran_SystemsOS Hub — Shared domain-prerequisite instructions.
-
-   SINGLE SOURCE OF TRUTH for the "you need a Njal.la domain + router port
-   forwarding" guidance that must read identically everywhere it appears:
-
-     • First-boot onboarding wizard (Server + Desktop role)
-       — onboarding.js step 3
-     • Feature-enable domain modal (Node role, and any role)
-       — features.js openDomainSetupModal()
-       (Lightning Wallet Connections / NWC, BTCPay Server, Haven, …)
-     • Domain reconfigure / troubleshooting modal
-       — features.js openDomainReconfigureModal()
-
-   Keep these three surfaces word-for-word consistent: always edit this
-   file, never fork the wording inline. Plain classic script (no modules) —
-   both templates load it with a plain <script> tag. */
-"use strict";
-
-/* Escape helper local to this file so it is self-contained on both pages. */
-function dpEsc(str) {
-  return String(str)
-    .replace(/&/g, "&amp;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;")
-    .replace(/'/g, "&#39;");
-}
-
-/* ── "What you'll need" intro ──────────────────────────────────────
-   opts.serviceName — e.g. "Lightning Wallet Connections", or null for
-   the multi-service (onboarding) wording.
-   opts.hostExample — e.g. "lightning" → lightning.yourdomain.com */
-function renderDomainNeedsHtml(opts) {
-  var serviceName = opts.serviceName || null;
-  var hostExample = dpEsc(opts.hostExample || "myservice");
-  var html = "";
-
-  if (serviceName) {
-    html += "<p>To enable <strong>" + dpEsc(serviceName) + "</strong>, you'll need two things first:</p>";
-    html += '<ol style="margin:8px 0 0 16px;padding:0;line-height:1.7;">';
-    html += "<li><strong>A domain of your own from <a href=\"https://njal.la\" target=\"_blank\" rel=\"noopener noreferrer\" style=\"color:var(--accent-color);\">Njal.la</a></strong> "
-      + "— privacy-friendly, no personal details required, accepts Bitcoin. "
-      + dpEsc(serviceName) + " gets its own hostname: a subdomain (e.g. <code>" + hostExample + ".yourdomain.com</code>) "
-      + "or a separate domain — your choice. Subdomains are free, and one domain can have many.</li>";
-    html += "<li><strong>Access to your router</strong> — you'll forward ports <strong>80</strong> and <strong>443</strong> (TCP) "
-      + "to this computer once. All domain-based services share these two ports; "
-      + "they're required for HTTPS and SSL certificates.</li>";
-    html += "</ol>";
-  } else {
-    html += "<p><strong>Each service below needs two things set up:</strong></p>";
-    html += '<ol style="margin:8px 0 0 16px;padding:0;line-height:1.7;">';
-    html += "<li><strong>A domain of your own from <a href=\"https://njal.la\" target=\"_blank\" rel=\"noopener noreferrer\" style=\"color:var(--accent-color);\">Njal.la</a></strong> "
-      + "— privacy-friendly, no personal details required, accepts Bitcoin. "
-      + "Each service gets its own hostname: its own subdomain (e.g. <code>" + hostExample + ".yourdomain.com</code>) "
-      + "or a separate domain — your choice. Subdomains are free, and one domain can have many, "
-      + "so a single domain can serve every service.</li>";
-    html += "<li><strong>Access to your router</strong> — you'll forward ports <strong>80</strong> and <strong>443</strong> (TCP) "
-      + "to this computer once. All domain-based services share these two ports; "
-      + "they're required for HTTPS and SSL certificates.</li>";
-    html += "</ol>";
-  }
-  return html;
-}
-
-/* ── "How to set it up at Njal.la" steps ───────────────────────────
-   opts.hostExample — host part used in the examples (default "call").
-   opts.pasteHint   — where the curl command goes:
-                      "below" (single service) or "next to its service below"
-                      (onboarding, many services). */
-function renderNjallaStepsHtml(opts) {
-  var hostExample = dpEsc((opts && opts.hostExample) || "call");
-  var pasteHint = (opts && opts.pasteHint) || "below";
-  var html = "";
-
-  html += "<p style=\"margin-top:12px;\"><strong>How to set it up at Njal.la:</strong></p>";
-  html += '<ol style="margin:8px 0 0 16px;padding:0;line-height:1.7;">';
-  html += "<li>Create an account at <a href=\"https://njal.la\" target=\"_blank\" rel=\"noopener noreferrer\" style=\"color:var(--accent-color);\">https://njal.la</a> and buy a domain.</li>";
-  html += "<li>Add a <strong>Dynamic</strong> record for the hostname:"
-    + '<ul style="margin:4px 0 0 16px;padding:0;line-height:1.7;">'
-    + "<li>In the Njal.la <strong>Name</strong> field, type ONLY the host part — the word before your domain.<br>"
-    + "(For &quot;" + hostExample + ".yourdomain.com&quot; you&apos;d type just: <code>" + hostExample + "</code>.)<br>"
-    + "&#9888; Do NOT type the full domain here — Njal.la adds it automatically.</li>"
-    + "<li>Dedicating a whole separate domain to this service? Leave the Name field blank or use <code>@</code>.</li>"
-    + "</ul>"
-    + "</li>";
-  html += "<li>A Dynamic record has <strong>NO IP field</strong> — you don&apos;t enter an IP anywhere. "
-    + "It auto-fills once Sovran_SystemsOS runs the update command (on save, and again after every reboot).</li>";
-  html += "<li>Njal.la gives you a curl command, e.g.:<br>"
-    + '<code style="font-size:0.8em;">curl &quot;https://njal.la/update/?h=' + hostExample + '.yourdomain.com&amp;k=abc123&amp;auto&quot;</code><br>'
-    + "Copy it and paste it " + pasteHint + ".</li>";
-  html += "</ol>";
-  return html;
-}
-
-/* ── "One router task" port-forwarding box ─────────────────────────
-   opts.internalIp  — LAN IP string, or empty/null for generic wording.
-   opts.plural      — true for multi-service (onboarding) wording.
-   opts.includeSsh  — also mention port 22 for SSH (onboarding).
-   opts.extraNote   — extra sentence appended at the end (optional). */
-function renderRouterPortsHtml(opts) {
-  opts = opts || {};
-  var ipPart = opts.internalIp
-    ? " to this computer&rsquo;s internal IP <strong>" + dpEsc(opts.internalIp) + "</strong>"
-    : " to this computer&rsquo;s internal IP";
-  var serviceWord = opts.plural ? "services" : "service";
-
-  var html = "";
-  html += "🔌 <strong>One router task:</strong> in your router&rsquo;s <strong>port forwarding</strong> settings, "
-    + "forward port <strong>80 (TCP)</strong> and port <strong>443 (TCP)</strong>"
-    + ipPart + ". Use the <strong>same number for the internal and external port</strong>. "
-    + "This only needs to be done once — all domain services share these ports — "
-    + "but HTTPS and SSL certificates won&rsquo;t work without them, so your " + serviceWord + " "
-    + "can&rsquo;t be reached from outside your home network. "
-    + "You&rsquo;ll need normal access to your router&rsquo;s settings with working port forwarding — "
-    + "if your ISP blocks it (e.g. CGNAT), domain-based services can&rsquo;t be reached from the internet. ";
-  if (opts.includeSsh) {
-    html += "Add port <strong>22 (TCP)</strong> as well if you want remote SSH access. ";
-  }
-  if (opts.extraNote) {
-    html += dpEsc(opts.extraNote);
-  }
-  return html;
-}
-
-/* ── Async helper: fill a router-box container with the internal IP ──
-   Renders generic text immediately, then upgrades to the concrete LAN IP
-   if /api/network provides one. Best-effort — never blocks the UI. */
-function renderRouterPortsBox(elId, opts) {
-  var el = document.getElementById(elId);
-  if (!el) return;
-  el.innerHTML = renderRouterPortsHtml(opts || {});
-  fetch("/api/network")
-    .then(function(r) { return r.json(); })
-    .then(function(data) {
-      var target = document.getElementById(elId);
-      if (!target) return;
-      var ip = data && data.internal_ip;
-      if (ip && ip !== "unavailable") {
-        var next = {};
-        for (var k in (opts || {})) next[k] = opts[k];
-        next.internalIp = String(ip).trim();
-        target.innerHTML = renderRouterPortsHtml(next);
-      }
-    })
-    .catch(function() { /* generic wording already shown — fine */ });
-}

app/sovran_systemsos_web/static/js/events.js

@@ -44,28 +44,6 @@ if ($upgradeCloseBtn) $upgradeCloseBtn.addEventListener("click", closeUpgradeMod
 if ($upgradeCancelBtn) $upgradeCancelBtn.addEventListener("click", closeUpgradeModal);
 if ($upgradeModal) $upgradeModal.addEventListener("click", function(e) { if (e.target === $upgradeModal) closeUpgradeModal(); });
 
-// Restart confirm dialog
-if ($restartConfirmCancel) $restartConfirmCancel.addEventListener("click", closeRestartConfirmDialog);
-if ($restartConfirmModal) $restartConfirmModal.addEventListener("click", function(e) { if (e.target === $restartConfirmModal) closeRestartConfirmDialog(); });
-if ($restartConfirmModal) $restartConfirmModal.addEventListener("keydown", function(e) { if (e.key === "Escape") closeRestartConfirmDialog(); });
-
-// Header Reboot button
-if ($headerRebootBtn) $headerRebootBtn.addEventListener("click", function() { openRestartConfirmDialog(); });
-if ($restartConfirmOk) $restartConfirmOk.addEventListener("click", function() {
-  if ($restartConfirmOk.disabled) return;
-  $restartConfirmOk.disabled = true;
-  closeRestartConfirmDialog();
-  doReboot();
-});
-
-// Reboot error card buttons
-var $rebootErrorCloseBtn = document.getElementById("reboot-error-close-btn");
-var $rebootErrorRetryBtn = document.getElementById("reboot-error-retry-btn");
-if ($rebootErrorCloseBtn) $rebootErrorCloseBtn.addEventListener("click", function() {
-  if ($rebootOverlay) $rebootOverlay.classList.remove("visible");
-});
-if ($rebootErrorRetryBtn) $rebootErrorRetryBtn.addEventListener("click", doReboot);
-
 // ── Upgrade modal functions ───────────────────────────────────────
 
 function openUpgradeModal() {
@@ -76,37 +54,6 @@ function closeUpgradeModal() {
   if ($upgradeModal) $upgradeModal.classList.remove("open");
 }
 
-// ── Restart confirm dialog functions ─────────────────────────────
-
-var _restartDialogOpener = null;
-
-function openRestartConfirmDialog() {
-  if (!$restartConfirmModal) return;
-  _restartDialogOpener = document.activeElement;
-
-  // Detect conflicting operations
-  var isOperationInProgress = !!_updatePollTimer || !!_rebuildPollTimer;
-  if ($restartConflictBox) $restartConflictBox.style.display = isOperationInProgress ? "" : "none";
-  if ($restartConfirmOk) $restartConfirmOk.disabled = isOperationInProgress;
-
-  $restartConfirmModal.classList.add("open");
-
-  // Focus Cancel initially for safety
-  var cancelBtn = document.getElementById("restart-confirm-cancel-btn");
-  if (cancelBtn) setTimeout(function() { cancelBtn.focus(); }, 50);
-}
-
-function closeRestartConfirmDialog() {
-  if ($restartConfirmModal) $restartConfirmModal.classList.remove("open");
-  // Re-enable confirm button for next open
-  if ($restartConfirmOk) $restartConfirmOk.disabled = false;
-  // Return focus to the element that opened the dialog
-  if (_restartDialogOpener && _restartDialogOpener.focus) {
-    try { _restartDialogOpener.focus(); } catch (_) {}
-    _restartDialogOpener = null;
-  }
-}
-
 async function doUpgradeToServer() {
   var confirmBtn = $upgradeConfirmBtn;
   if (confirmBtn) { confirmBtn.disabled = true; confirmBtn.textContent = "Upgrading…"; }

app/sovran_systemsos_web/static/js/features.js

@@ -59,8 +59,6 @@ function openDomainSetupModal(feat, onSaved) {
   if (!$domainSetupModal) return;
   if ($domainSetupTitle) $domainSetupTitle.textContent = "🌐 Domain Setup — " + feat.name;
 
-  var isWalletConnections = (feat.id === "nwc-wallets" || feat.domain_name === "lightning");
-
   var npubField = "";
   if (feat.id === "haven") {
     var currentNpub = "";
@@ -75,32 +73,23 @@ function openDomainSetupModal(feat, onSaved) {
     npubField = '<div class="domain-field-group"><label class="domain-field-label" for="domain-npub-input">Nostr Public Key (npub1...):</label><input class="domain-field-input" type="text" id="domain-npub-input" placeholder="npub1..." value="' + escHtml(currentNpub) + '" /></div>';
   }
 
-  var nwcWarning = isWalletConnections
-    ? '<div class="domain-nwc-warning">' +
-      '<strong>⚠ Lightning Wallet Connections requires its own unique hostname.</strong> ' +
-      'Use a new subdomain such as <code>lightning.yourdomain.com</code>, or a separate domain. ' +
-      'Do not reuse a domain already assigned to Matrix, Nextcloud, WordPress, BTCPay Server, Vaultwarden, Haven, or another Caddy site.' +
-      '</div>'
-    : '';
-
-  var domainPlaceholder = isWalletConnections ? "lightning.yourdomain.com" : "myservice.example.com";
-  var domainLabelExample = isWalletConnections ? "lightning.yourdomain.com" : "call.yourdomain.com";
-
-  // Shared instructions (single source of truth: static/js/domain-prereqs.js) —
-  // identical wording to the Server + Desktop onboarding wizard and every other
-  // domain-based feature, regardless of role (Node / Desktop / Server+Desktop).
-  var hostExample = isWalletConnections ? "lightning" : "call";
+  var externalIp = _cachedExternalIp || "your external IP";
 
   $domainSetupBody.innerHTML =
     '<div class="domain-setup-intro">' +
-    nwcWarning +
-    renderDomainNeedsHtml({ serviceName: feat.name, hostExample: hostExample }) +
-    renderNjallaStepsHtml({ hostExample: hostExample, pasteHint: "below" }) +
-    '<div class="onboarding-port-warn" id="domain-router-box" style="margin-top:12px;"></div>' +
-    '<p style="margin-top:10px;">Below, enter the full domain for this service — a subdomain (e.g. ' + domainLabelExample + ') or a separate domain — and paste its curl command.</p>' +
+    '<p><strong>Before continuing:</strong></p>' +
+    '<ol>' +
+    '<li>Create an account at <a href="https://njal.la" target="_blank" rel="noopener noreferrer" style="color:var(--accent-color);">https://njal.la</a></li>' +
+    '<li>Purchase a new domain on Njal.la, or create a subdomain from a domain you already own. Tip: Subdomains are free to create — you only need to purchase one domain, and you can add as many subdomains as you need at no extra cost.</li>' +
+    '<li>In the Njal.la web interface, create a <strong>Dynamic</strong> record pointing to this machine\'s external IP address:<br>' +
+    '<span style="display:inline-block;margin-top:4px;padding:4px 10px;background:var(--card-color);border:1px solid var(--border-color);border-radius:6px;font-family:monospace;font-size:1em;font-weight:700;">' + escHtml(externalIp) + '</span></li>' +
+    '<li>Njal.la will give you a curl command like:<br>' +
+    '<code style="font-size:0.8em;">curl &quot;https://njal.la/update/?h=sub.domain.com&amp;k=abc123&amp;auto&quot;</code></li>' +
+    '<li>Enter the subdomain and paste that curl command below</li>' +
+    '</ol>' +
     '</div>' +
-    '<div class="domain-field-group"><label class="domain-field-label" for="domain-subdomain-input">Service domain (e.g. ' + domainLabelExample + '):</label><input class="domain-field-input" type="text" id="domain-subdomain-input" placeholder="' + domainPlaceholder + '" /></div>' +
-    '<div class="domain-field-group"><label class="domain-field-label" for="domain-ddns-input">Njal.la Dynamic DNS Update Command:</label><input class="domain-field-input" type="text" id="domain-ddns-input" placeholder="curl &quot;https://njal.la/update/?h=' + domainPlaceholder + '&amp;k=abc123&amp;auto&quot;" /><p class="domain-field-hint">ℹ Paste the full curl command from your Njal.la dashboard\'s Dynamic record</p></div>' +
+    '<div class="domain-field-group"><label class="domain-field-label" for="domain-subdomain-input">Subdomain (e.g. myservice.example.com):</label><input class="domain-field-input" type="text" id="domain-subdomain-input" placeholder="myservice.example.com" /></div>' +
+    '<div class="domain-field-group"><label class="domain-field-label" for="domain-ddns-input">Njal.la Dynamic DNS Update Command:</label><input class="domain-field-input" type="text" id="domain-ddns-input" placeholder="curl &quot;https://njal.la/update/?h=myservice.example.com&amp;k=abc123&amp;auto&quot;" /><p class="domain-field-hint">ℹ Paste the full curl command from your Njal.la dashboard\'s Dynamic record</p></div>' +
     npubField +
     '<div class="domain-field-actions"><button class="btn btn-close-modal" id="domain-setup-cancel-btn">Cancel</button><button class="btn btn-primary" id="domain-setup-save-btn">Save &amp; Enable</button></div>';
 
@@ -114,7 +103,7 @@ function openDomainSetupModal(feat, onSaved) {
     ddnsUrl   = ddnsUrl.trim();
     npub      = npub.trim();
 
-    if (!subdomain) { alert("Please enter a domain."); return; }
+    if (!subdomain) { alert("Please enter a subdomain."); return; }
     if (feat.id === "haven" && !npub) { alert("Please enter your Nostr public key."); return; }
 
     var saveBtn = document.getElementById("domain-setup-save-btn");
@@ -136,23 +125,17 @@ function openDomainSetupModal(feat, onSaved) {
     } catch (err) {
       saveBtn.disabled = false;
       saveBtn.textContent = "Save & Enable";
-      var msg = (err && err.message) ? err.message : "Failed to save domain. Please try again.";
-      alert(msg);
+      alert("Failed to save domain. Please try again.");
     }
   });
 
   $domainSetupModal.classList.add("open");
-
-  // Fill the router port-forwarding box with this computer's LAN IP (best-effort)
-  renderRouterPortsBox("domain-router-box");
 }
 
 function openDomainReconfigureModal(feat, existingDomain, onSaved) {
   if (!$domainSetupModal) return;
   if ($domainSetupTitle) $domainSetupTitle.textContent = "🔄 Reconfigure Domain — " + feat.name;
 
-  var isWalletConnections = (feat.id === "nwc-wallets" || feat.domain_name === "lightning");
-
   var npubField = "";
   if (feat.id === "haven") {
     var currentNpub = "";
@@ -167,38 +150,24 @@ function openDomainReconfigureModal(feat, existingDomain, onSaved) {
     npubField = '<div class="domain-field-group"><label class="domain-field-label" for="domain-npub-input">Nostr Public Key (npub1...):</label><input class="domain-field-input" type="text" id="domain-npub-input" placeholder="npub1..." value="' + escHtml(currentNpub) + '" /></div>';
   }
 
-  var nwcWarning = isWalletConnections
-    ? '<div class="domain-nwc-warning">' +
-      '<strong>⚠ Lightning Wallet Connections requires its own unique hostname.</strong> ' +
-      'Use a new subdomain such as <code>lightning.yourdomain.com</code>, or a separate domain. ' +
-      'Do not reuse a domain already assigned to Matrix, Nextcloud, WordPress, BTCPay Server, Vaultwarden, Haven, or another Caddy site.' +
-      '</div>'
-    : '';
-
-  var domainPlaceholder = isWalletConnections ? "lightning.yourdomain.com" : "myservice.example.com";
-  var domainLabelExample = isWalletConnections ? "lightning.yourdomain.com" : "call.yourdomain.com";
-
   var externalIp = _cachedExternalIp || "your external IP";
   var currentDomain = existingDomain || "";
 
   $domainSetupBody.innerHTML =
     '<div class="domain-setup-intro">' +
-    nwcWarning +
     '<p>Your domain <strong>' + escHtml(currentDomain || "this domain") + '</strong> is configured but isn\'t resolving correctly.</p>' +
     '<p><strong>Troubleshooting steps:</strong></p>' +
     '<ol>' +
     '<li>Log into your Njal.la dashboard at <a href="https://njal.la" target="_blank" rel="noopener noreferrer" style="color:var(--accent-color);">https://njal.la</a></li>' +
-    '<li>Find the DNS record for <strong>' + escHtml(currentDomain || "your domain") + '</strong>. In Njal.la\'s Name field, note that only the host part is stored (the word before the domain) — not the full domain.</li>' +
+    '<li>Find the DNS record for <strong>' + escHtml(currentDomain || "your domain") + '</strong></li>' +
     '<li>Verify it has a <strong>Dynamic</strong> record pointing to your current external IP:<br>' +
     '<span style="display:inline-block;margin-top:4px;padding:4px 10px;background:var(--card-color);border:1px solid var(--border-color);border-radius:6px;font-family:monospace;font-size:1em;font-weight:700;">' + escHtml(externalIp) + '</span></li>' +
     '<li>If the IP is wrong or the record is missing, update it</li>' +
     '<li>If you changed the DDNS curl command, paste the updated one below</li>' +
-    '<li>Confirm ports <strong>80</strong> and <strong>443</strong> (TCP) are still forwarded on your router to this computer — see the reminder below:</li>' +
     '</ol>' +
-    '<div class="onboarding-port-warn" id="domain-router-box" style="margin-top:12px;"></div>' +
     '</div>' +
-    '<div class="domain-field-group"><label class="domain-field-label" for="domain-subdomain-input">Service domain (e.g. ' + domainLabelExample + '):</label><input class="domain-field-input" type="text" id="domain-subdomain-input" placeholder="' + domainPlaceholder + '" value="' + escHtml(currentDomain) + '" /></div>' +
-    '<div class="domain-field-group"><label class="domain-field-label" for="domain-ddns-input">Njal.la Dynamic DNS Update Command:</label><input class="domain-field-input" type="text" id="domain-ddns-input" placeholder="curl &quot;https://njal.la/update/?h=' + domainPlaceholder + '&amp;k=abc123&amp;auto&quot;" /><p class="domain-field-hint">ℹ Paste the full curl command from your Njal.la dashboard\'s Dynamic record</p></div>' +
+    '<div class="domain-field-group"><label class="domain-field-label" for="domain-subdomain-input">Subdomain (e.g. myservice.example.com):</label><input class="domain-field-input" type="text" id="domain-subdomain-input" placeholder="myservice.example.com" value="' + escHtml(currentDomain) + '" /></div>' +
+    '<div class="domain-field-group"><label class="domain-field-label" for="domain-ddns-input">Njal.la Dynamic DNS Update Command:</label><input class="domain-field-input" type="text" id="domain-ddns-input" placeholder="curl &quot;https://njal.la/update/?h=myservice.example.com&amp;k=abc123&amp;auto&quot;" /><p class="domain-field-hint">ℹ Paste the full curl command from your Njal.la dashboard\'s Dynamic record</p></div>' +
     npubField +
     '<div class="domain-field-actions"><button class="btn btn-close-modal" id="domain-setup-cancel-btn">Cancel</button><button class="btn btn-primary" id="domain-setup-save-btn">Save &amp; Update</button></div>';
 
@@ -234,15 +203,11 @@ function openDomainReconfigureModal(feat, existingDomain, onSaved) {
     } catch (err) {
       saveBtn.disabled = false;
       saveBtn.textContent = "Save & Update";
-      var msg = (err && err.message) ? err.message : "Failed to save domain. Please try again.";
-      alert(msg);
+      alert("Failed to save domain. Please try again.");
     }
   });
 
   $domainSetupModal.classList.add("open");
-
-  // Fill the router port-forwarding box with this computer's LAN IP (best-effort)
-  renderRouterPortsBox("domain-router-box");
 }
 
 function closeDomainSetupModal() {
@@ -259,12 +224,28 @@ function openPortRequirementsModal(featureName, ports, onContinue) {
     : '';
 
   function renderPortRequirements(internalIp) {
+    var rows = ports.map(function(p) {
+      return '<tr><td class="port-req-port">' + escHtml(p.port) + '</td>' +
+        '<td class="port-req-proto">' + escHtml(p.protocol) + '</td>' +
+        '<td class="port-req-desc">' + escHtml(p.description) + '</td></tr>';
+    }).join("");
+    var ipLine = internalIp
+      ? '<p class="port-req-intro">Forward each port below <strong>to this machine\'s internal IP: <code class="port-req-internal-ip">' + escHtml(internalIp) + '</code></strong></p>'
+      : "<p class=\"port-req-intro\">Forward each port below to this machine's internal LAN IP in your router's port forwarding settings.</p>";
+
     $portReqBody.innerHTML =
-      renderPortForwardGuideHtml(ports, {
-        internalIp: internalIp,
-        serviceName: featureName,
-      }) +
-      '<p class="port-req-hint">💡 This list is always available again on the <strong>' + escHtml(featureName) + '</strong> tile.</p>' +
+      '<p class="port-req-intro"><strong>Port Forwarding Required</strong></p>' +
+      '<p class="port-req-intro">For <strong>' + escHtml(featureName) + "</strong> to work with clients outside your local network, " +
+      "you must configure <strong>port forwarding</strong> in your router's admin panel.</p>" +
+      ipLine +
+      '<table class="port-req-table">' +
+      '<thead><tr><th>Port(s)</th><th>Protocol</th><th>Purpose</th></tr></thead>' +
+      '<tbody>' + rows + '</tbody>' +
+      '</table>' +
+      "<p class=\"port-req-hint\"><strong>How to verify:</strong> Router-side forwarding cannot be checked from inside your network. " +
+      "To confirm ports are forwarded correctly, test from a device on a different network (e.g. a phone on mobile data) " +
+      "or check your router's port forwarding page.</p>" +
+      '<p class="port-req-hint">ℹ Search "<em>how to set up port forwarding on [your router model]</em>" for step-by-step instructions.</p>' +
       '<div class="domain-field-actions">' +
       '<button class="btn btn-close-modal" id="port-req-dismiss-btn">Dismiss</button>' +
       continueBtn +
@@ -397,10 +378,39 @@ function handleFeatureToggle(feat, newEnabled) {
       return;
     }
 
-    // Always show the full list of ports to forward. Port forwarding happens on
-    // the router, which this computer cannot inspect — a local check would only
-    // hide ports the user still has to open.
-    openPortRequirementsModal(feat.name, ports, proceedAfterPortCheck);
+    // Check which ports are actually closed before showing the modal
+    fetch("/api/ports/status", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ ports: ports }),
+    })
+      .then(function(r) {
+        if (!r.ok) throw new Error("Port status request failed: " + r.status);
+        return r.json();
+      })
+      .then(function(data) {
+        var portStatuses = {};
+        (data.ports || []).forEach(function(p) {
+          portStatuses[p.port + "/" + p.protocol] = p.status;
+        });
+
+        var closedPorts = ports.filter(function(p) {
+          var key = p.port + "/" + p.protocol;
+          var status = portStatuses[key] || "unknown";
+          return status !== "listening" && status !== "firewall_open";
+        });
+
+        if (closedPorts.length === 0) {
+          proceedAfterPortCheck();
+        } else {
+          openPortRequirementsModal(feat.name, closedPorts, proceedAfterPortCheck);
+        }
+      })
+      .catch(function(err) {
+        console.warn("Failed to fetch port status for feature enable flow:", err);
+        // Safe fallback if status check fails
+        openPortRequirementsModal(feat.name, ports, proceedAfterPortCheck);
+      });
   }
 
   if (feat.id === "bitcoin-core") {

app/sovran_systemsos_web/static/js/helpers.js

@@ -40,66 +40,6 @@ function linkify(str) {
   return escHtml(str).replace(/(https?:\/\/[^\s<]+)/g, '<a href="$1" target="_blank" rel="noopener noreferrer" class="creds-link">$1</a>');
 }
 
-// ── Router port-forwarding guide ──────────────────────────────────
-// Whether a port is truly reachable can only be judged from OUTSIDE the
-// network, so we never show a local "ready" verdict here. We only tell the
-// user exactly what to enter in their router.
-
-// Render the protocol cell so TCP / UDP / both is unmistakable.
-function portProtocolHtml(protocol) {
-  var p = String(protocol || "TCP").toUpperCase();
-  var isTcp = p.indexOf("TCP") !== -1;
-  var isUdp = p.indexOf("UDP") !== -1;
-  if (isTcp && isUdp) {
-    return '<span class="port-proto-badge port-proto-badge--both">TCP + UDP</span>' +
-      '<span class="port-proto-note">both required</span>';
-  }
-  if (isUdp) return '<span class="port-proto-badge port-proto-badge--udp">UDP</span>';
-  return '<span class="port-proto-badge port-proto-badge--tcp">TCP</span>';
-}
-
-// ports: [{ port, protocol, description }]
-// opts:  { internalIp, serviceName, tableClass, introClass, noteClass }
-function renderPortForwardGuideHtml(ports, opts) {
-  opts = opts || {};
-  var tableClass = opts.tableClass || "port-req-table";
-  var introClass = opts.introClass || "port-req-intro";
-  var noteClass  = opts.noteClass  || "port-req-hint";
-  var ipHtml = opts.internalIp
-    ? '<code class="port-req-internal-ip">' + escHtml(opts.internalIp) + '</code>'
-    : 'this computer&rsquo;s <strong>internal IP</strong> (shown as &ldquo;Internal IP&rdquo; at the top of the Hub dashboard)';
-
-  var rows = (ports || []).map(function(p) {
-    return '<tr>' +
-      '<td class="port-req-port">' + escHtml(p.port) + '</td>' +
-      '<td class="port-req-proto">' + portProtocolHtml(p.protocol) + '</td>' +
-      '<td class="port-req-desc">' + escHtml(p.description || "") + '</td>' +
-      '</tr>';
-  }).join("");
-
-  var forWhat = opts.serviceName
-    ? 'For <strong>' + escHtml(opts.serviceName) + '</strong> to be reachable from outside your home network, open'
-    : 'Open';
-
-  return '<p class="' + introClass + '">' +
-      forWhat + ' the ports below in your router&rsquo;s <strong>port forwarding</strong> settings ' +
-      'and point them at ' + ipHtml + '.' +
-    '</p>' +
-    '<ul class="port-req-steps">' +
-      '<li>Set the <strong>internal (private) port</strong> and the <strong>external (public) port</strong> to the <strong>same number</strong>.</li>' +
-      '<li>Match the <strong>protocol</strong> exactly — a rule set to TCP will not pass UDP traffic. Where the table says <strong>TCP + UDP</strong>, create both rules (or pick &ldquo;Both&rdquo;/&ldquo;TCP/UDP&rdquo; if your router offers it).</li>' +
-      '<li>For a range such as <strong>30000-40000</strong>, use your router&rsquo;s port-range fields — start 30000, end 40000 — rather than one rule per port.</li>' +
-    '</ul>' +
-    '<table class="' + tableClass + '">' +
-      '<thead><tr><th>Port(s)</th><th>Protocol</th><th>Used for</th></tr></thead>' +
-      '<tbody>' + rows + '</tbody>' +
-    '</table>' +
-    '<p class="' + noteClass + '">' +
-      '📱 <strong>How to confirm it worked:</strong> forwarding happens on your router, so it can only be verified from outside your network. ' +
-      'Turn Wi-Fi off on your phone and open the service over mobile data — if it loads, your ports are open.' +
-    '</p>';
-}
-
 function formatDuration(seconds) {
   const h = Math.floor(seconds / 3600);
   const m = Math.floor((seconds % 3600) / 60);
@@ -115,20 +55,7 @@ async function apiFetch(path, options) {
   const res = await fetch(path, options || {});
   if (!res.ok) {
     let detail = res.status + " " + res.statusText;
-    try {
-      const body = await res.json();
-      if (body && body.detail) {
-        if (typeof body.detail === "string") {
-          detail = body.detail;
-        } else if (body.detail && typeof body.detail.message === "string") {
-          detail = body.detail.message;
-        }
-      } else if (body && typeof body.message === "string") {
-        detail = body.message;
-      } else if (body && typeof body.error === "string") {
-        detail = body.error;
-      }
-    } catch (e) {}
+    try { const body = await res.json(); if (body && body.detail) detail = body.detail; } catch (e) {}
     throw new Error(detail);
   }
   return res.json();

app/sovran_systemsos_web/static/js/rebuild.js

@@ -69,7 +69,7 @@ function onRebuildDone(result) {
     // Auto-reload the page after a short delay so tiles and toggles reflect the new state
     setTimeout(function() { window.location.reload(); }, 1200);
   } else if (result === "reboot_required") {
-    if ($rebuildStatus) $rebuildStatus.textContent = "✓ Done — restart required";
+    if ($rebuildStatus) $rebuildStatus.textContent = "✓ Done — reboot required";
     if ($rebuildReboot) $rebuildReboot.style.display = "inline-flex";
   } else {
     if ($rebuildStatus) $rebuildStatus.textContent = "✗ Something went wrong";

app/sovran_systemsos_web/static/js/security.js

@@ -145,25 +145,28 @@ function openSecurityModal() {
           if (rebootBtn) {
             // Keep button disabled for 5 seconds to prevent accidental clicks
             var countdown = 5;
-            rebootBtn.textContent = "I have written down my new password \u2014 Restart Entire System (" + countdown + ")";
+            rebootBtn.textContent = "I have written down my new password \u2014 Reboot now (" + countdown + ")";
             var timer = setInterval(function() {
               countdown--;
               if (countdown <= 0) {
                 clearInterval(timer);
                 rebootBtn.disabled = false;
-                rebootBtn.textContent = "I have written down my new password \u2014 Restart Entire System";
+                rebootBtn.textContent = "I have written down my new password \u2014 Reboot now";
               } else {
-                rebootBtn.textContent = "I have written down my new password \u2014 Restart Entire System (" + countdown + ")";
+                rebootBtn.textContent = "I have written down my new password \u2014 Reboot now (" + countdown + ")";
               }
             }, 1000);
 
             rebootBtn.addEventListener("click", function() {
               rebootBtn.disabled = true;
-              rebootBtn.textContent = "Restarting\u2026";
-              // Hide the security reset overlay so the shared reboot overlay is visible
-              var $secResetOverlay2 = document.getElementById("security-reset-overlay");
-              if ($secResetOverlay2) $secResetOverlay2.classList.remove("visible");
-              doReboot();
+              rebootBtn.textContent = "Rebooting\u2026";
+              if ($rebootOverlay) $rebootOverlay.classList.add("visible");
+              _rebootStartTime = Date.now();
+              _serverWentDown = false;
+              setTimeout(waitForServerReboot, REBOOT_INITIAL_DELAY);
+              var rebootCtrl = new AbortController();
+              setTimeout(function() { rebootCtrl.abort(); }, REBOOT_REQUEST_TIMEOUT);
+              fetch("/api/reboot", { method: "POST", signal: rebootCtrl.signal }).catch(function() {});
             }, { once: true });
           }
         } catch (err) {

app/sovran_systemsos_web/static/js/service-detail.js

@@ -2,21 +2,6 @@
 
 // ── Service detail modal ──────────────────────────────────────────
 
-function _getZeusConnectGuideHtml() {
-  return '<div class="nwc-connect-guide">' +
-    '<div class="nwc-connect-guide-title">📱 Connect to Zeus</div>' +
-    '<p class="nwc-connect-guide-intro">This connection URL is an <strong>LND REST</strong> connection — the direct way to use Zeus with your node for full admin access. It connects securely through Tor, allowing you to manage channels, balances, and your full node on the go.</p>' +
-    '<div class="nwc-connect-steps">' +
-      '<div class="nwc-connect-step"><div class="nwc-step-num">1</div><div><strong>Download Zeus</strong> from the App Store or Google Play.</div></div>' +
-      '<div class="nwc-connect-step"><div class="nwc-step-num">2</div><div>Open Zeus and open the <strong>Wallets</strong> screen.</div></div>' +
-      '<div class="nwc-connect-step"><div class="nwc-step-num">3</div><div>Tap the <strong>+ (Add Wallet)</strong> button in the top-right corner.</div></div>' +
-      '<div class="nwc-connect-step"><div class="nwc-step-num">4</div><div>On <strong>Wallet Configuration</strong>, tap the <strong>scan icon</strong> in the top-right corner, then scan the QR code above.</div></div>' +
-      '<div class="nwc-connect-step"><div class="nwc-step-num">5</div><div>Zeus detects the LND REST QR and fills in the connection details. Review them, then tap <strong>Save Wallet Config</strong>.</div></div>' +
-    '</div>' +
-    '<div class="nwc-connect-note"><strong>💡 Note:</strong> This is <em>not</em> the same as the NWC pairing QR shown in Lightning Wallet Connections — that gives your wallet sandboxed, limited access for everyday spending. LND REST connects Zeus directly to your node for full admin control.</div>' +
-  '</div>';
-}
-
 function _renderCredsHtml(credentials, unit) {
   var html = "";
   for (var i = 0; i < credentials.length; i++) {
@@ -24,10 +9,7 @@ function _renderCredsHtml(credentials, unit) {
     var id = "cred-" + Math.random().toString(36).substring(2, 8);
     var qrBlock = "";
     if (cred.qrcode) {
-      var qrHint = (unit === "zeus-connect-setup.service")
-        ? "This is an <strong>LND REST</strong> connection QR — in Zeus, add a wallet and use the scan icon (see steps below)."
-        : "In Zeus: <em>Wallets → + → scan icon</em>. This is an <strong>LND REST</strong> QR for direct node access.";
-      qrBlock = '<div class="creds-qr-wrap"><img class="creds-qr-img" src="' + cred.qrcode + '" alt="QR Code for ' + escHtml(cred.label) + '"><div class="creds-qr-hint">' + qrHint + '</div></div>';
+      qrBlock = '<div class="creds-qr-wrap"><img class="creds-qr-img" src="' + cred.qrcode + '" alt="QR Code for ' + escHtml(cred.label) + '"><div class="creds-qr-hint">Scan with Zeus app on your phone</div></div>';
     }
     // If qronly, render the label + QR block only — skip value and copy button
     if (cred.qronly) {
@@ -76,562 +58,8 @@ function _attachCopyHandlers(container) {
   });
 }
 
-var _nwcModalState = null;
-
-function _isNwcServiceUnit(unit) {
-  // The dashboard tile is backed by Alby Hub, while older drafts referred to
-  // the logical feature as nwc-wallets.service. Support both so the Wallet
-  // Connections manager appears from the actual tile and any legacy configs.
-  return unit === "albyhub.service" || unit === "nwc-wallets.service";
-}
-
-function _nwcStateMessageHtml() {
-  if (!_nwcModalState || !_nwcModalState.message) return "";
-  var msgClass = _nwcModalState.messageKind === "success" ? "success" : "error";
-  return '<div class="matrix-form-result ' + msgClass + '">' + escHtml(_nwcModalState.message) + '</div>';
-}
-
-function _nwcSetMessage(kind, text) {
-  if (!_nwcModalState) return;
-  _nwcModalState.messageKind = kind || "error";
-  _nwcModalState.message = text || "";
-}
-
-function _nwcClearMessage() {
-  if (!_nwcModalState) return;
-  _nwcModalState.messageKind = "";
-  _nwcModalState.message = "";
-}
-
-function _nwcWalletSectionEl() {
-  return document.getElementById("nwc-wallets-body");
-}
-
-function _nwcFormatSats(value) {
-  var n = Number(value || 0);
-  if (!Number.isFinite(n)) n = 0;
-  return n.toLocaleString("en-US");
-}
-
-// "Go to Service & Setup" shortcut shown when no Lightning Address domain
-// is configured yet — jumps to the sibling tab instead of dead-ending.
-function _nwcWireDomainLink() {
-  var link = document.getElementById("nwc-domain-setup-link");
-  if (link) link.addEventListener("click", function() { _nwcActivateTab("setup"); });
-}
-
-// ── Lightning Wallet Connections: tabbed modal shell ──────────────
-// The wallet manager is a small app in its own right, so it gets the full
-// width of the dialog on a "Wallets" tab, while status / enable / domain /
-// ports / restart live on a "Service & Setup" tab.
-
-function _setCredsDialogWide(on) {
-  if (!$credsModal) return;
-  var dialog = $credsModal.querySelector(".creds-dialog");
-  if (dialog) dialog.classList.toggle("creds-dialog--wide", !!on);
-}
-
-function _nwcTabsShellHtml(opts) {
-  var domainChip = opts.domain
-    ? '<span class="nwc-header-chip nwc-header-chip--domain" title="Lightning Address domain">🌐 ' + escHtml(opts.domain) + '</span>'
-    : '<span class="nwc-header-chip nwc-header-chip--warn" title="No Lightning Address domain configured yet">🌐 Domain not set</span>';
-
-  return '<div class="nwc-tabs" data-active="' + escHtml(opts.activeTab) + '">' +
-    '<div class="nwc-tabs-bar" role="tablist" aria-label="Lightning Wallet Connections sections">' +
-      '<div class="nwc-tabs-btns">' +
-        '<button class="nwc-tab-btn" role="tab" data-tab="wallets" id="nwc-tab-btn-wallets" aria-controls="nwc-tab-wallets">⚡ Wallets</button>' +
-        '<button class="nwc-tab-btn" role="tab" data-tab="setup" id="nwc-tab-btn-setup" aria-controls="nwc-tab-setup">⚙ Service &amp; Setup</button>' +
-      '</div>' +
-      '<div class="nwc-header-chips">' +
-        '<span class="nwc-header-chip"><span class="status-dot ' + opts.statusDotClass + '"></span>' + escHtml(opts.statusLabel) + '</span>' +
-        domainChip +
-      '</div>' +
-    '</div>' +
-    '<div class="nwc-tab-panel" role="tabpanel" id="nwc-tab-wallets" aria-labelledby="nwc-tab-btn-wallets" data-tab="wallets">' + opts.walletsHtml + '</div>' +
-    '<div class="nwc-tab-panel" role="tabpanel" id="nwc-tab-setup" aria-labelledby="nwc-tab-btn-setup" data-tab="setup">' + opts.setupHtml + '</div>' +
-  '</div>';
-}
-
-function _nwcActivateTab(tab) {
-  var root = document.querySelector(".nwc-tabs");
-  if (!root) return;
-  root.setAttribute("data-active", tab);
-  root.querySelectorAll(".nwc-tab-btn").forEach(function(btn) {
-    var on = btn.getAttribute("data-tab") === tab;
-    btn.classList.toggle("active", on);
-    btn.setAttribute("aria-selected", on ? "true" : "false");
-  });
-  root.querySelectorAll(".nwc-tab-panel").forEach(function(panel) {
-    panel.classList.toggle("active", panel.getAttribute("data-tab") === tab);
-  });
-  var body = document.getElementById("creds-body");
-  if (body) body.scrollTop = 0;
-}
-
-function _nwcWireTabs() {
-  var root = document.querySelector(".nwc-tabs");
-  if (!root) return;
-  root.querySelectorAll(".nwc-tab-btn").forEach(function(btn) {
-    btn.addEventListener("click", function() {
-      _nwcActivateTab(btn.getAttribute("data-tab"));
-    });
-  });
-  _nwcActivateTab(root.getAttribute("data-active") || "wallets");
-  var gotoSetup = document.getElementById("nwc-goto-setup-btn");
-  if (gotoSetup) gotoSetup.addEventListener("click", function() { _nwcActivateTab("setup"); });
-}
-
-function _nwcRenderWalletState() {
-  var host = _nwcWalletSectionEl();
-  if (!host || !_nwcModalState) return;
-  var state = _nwcModalState;
-  var html = "";
-  html += _nwcStateMessageHtml();
-
-  if (state.view === "create") {
-    var selectedLimited = state.createForm.access_preset === "send_receive_limited";
-    html +=
-      '<div class="nwc-tab-intro-title">Create a Wallet</div>' +
-      '<p class="nwc-tab-intro-desc">Create a secure, sandboxed wallet for a specific app. Each wallet gets its own Lightning Address and optional spending limit.</p>' +
-      '<div class="matrix-form-group"><label class="matrix-form-label" for="nwc-wallet-name">Wallet Name</label>' +
-        '<input class="matrix-form-input" id="nwc-wallet-name" type="text" placeholder="My Wallet" value="' + escHtml(state.createForm.name || "") + '" autocomplete="off"></div>' +
-      '<div class="matrix-form-group"><label class="matrix-form-label" for="nwc-wallet-alias">Lightning Address Alias</label>' +
-        '<input class="matrix-form-input" id="nwc-wallet-alias" type="text" placeholder="my-wallet" value="' + escHtml(state.createForm.alias || "") + '" autocomplete="off">' +
-        '<div class="creds-qr-hint">Lowercase letters, numbers, "_" and "-" only.</div></div>' +
-      '<div class="matrix-form-group"><label class="matrix-form-label" for="nwc-wallet-preset">Access Preset</label>' +
-        '<select class="matrix-form-input" id="nwc-wallet-preset">' +
-          '<option value="receive_only"' + (state.createForm.access_preset === "receive_only" ? " selected" : "") + '>Receive only</option>' +
-          '<option value="send_receive_limited"' + (selectedLimited ? " selected" : "") + '>Send + receive (limited)</option>' +
-        '</select></div>' +
-      '<div class="matrix-form-group"><label class="matrix-form-label" for="nwc-wallet-limit">Spending Limit (sats)</label>' +
-        '<input class="matrix-form-input" id="nwc-wallet-limit" type="number" min="1" step="1" placeholder="50000" value="' + escHtml(state.createForm.spending_limit_sats || "") + '"' + (selectedLimited ? "" : " disabled") + "></div>" +
-      '<div class="matrix-form-actions">' +
-        '<button class="matrix-form-back" id="nwc-create-cancel-btn"' + (state.busy ? " disabled" : "") + '>← Back</button>' +
-        '<button class="matrix-form-submit" id="nwc-create-submit-btn"' + (state.busy ? " disabled" : "") + '>' + (state.busy ? "Creating…" : "Create Wallet") + '</button>' +
-      '</div>';
-    host.innerHTML = html;
-    var presetSel = document.getElementById("nwc-wallet-preset");
-    if (presetSel) {
-      presetSel.addEventListener("change", function() {
-        state.createForm.access_preset = presetSel.value;
-        _nwcRenderWalletState();
-      });
-    }
-    var cancelBtn = document.getElementById("nwc-create-cancel-btn");
-    if (cancelBtn) {
-      cancelBtn.addEventListener("click", function() {
-        if (state.busy) return;
-        state.view = state.wallets.length > 0 ? "list" : "empty";
-        _nwcClearMessage();
-        _nwcRenderWalletState();
-      });
-    }
-    var submitBtn = document.getElementById("nwc-create-submit-btn");
-    if (submitBtn) submitBtn.addEventListener("click", _nwcCreateWallet);
-    return;
-  }
-
-  if (state.view === "created" && state.lastCreated) {
-    var created = state.lastCreated;
-    var pairId = "nwc-pairing-uri-" + Math.random().toString(36).substring(2, 8);
-    html += '<div class="nwc-secret-warning">⚠ One-time pairing secret. Save it now — it will not be shown again.</div>';
-    if (created.pairing_qrcode) {
-      html += '<div class="creds-row"><div class="creds-label">QR Code</div>' +
-        '<div class="creds-qr-wrap"><img class="creds-qr-img" src="' + created.pairing_qrcode + '" alt="QR code for Lightning Wallet Connections pairing secret"><div class="creds-qr-hint">This is an <strong>NWC</strong> pairing QR — in Zeus, add a wallet and use the scan icon (see steps below).</div></div></div>';
-    }
-    html += '<div class="creds-row"><div class="creds-label">Pairing URI</div>' +
-      '<div class="creds-value-wrap"><div class="creds-value" id="' + pairId + '">' + escHtml(created.pairing_uri || "Unavailable") + '</div><button class="creds-copy-btn" data-target="' + pairId + '">Copy</button></div></div>';
-    if (created.wallet && created.wallet.lightning_address) {
-      html += '<div class="creds-row"><div class="creds-label">Lightning Address</div>' +
-        '<div class="creds-value-wrap"><div class="creds-value">' + escHtml(created.wallet.lightning_address) + '</div></div></div>';
-    }
-    html += '<div class="nwc-connect-guide">' +
-      '<div class="nwc-connect-guide-title">📱 Connect to Zeus</div>' +
-      '<p class="nwc-connect-guide-intro">This pairing URI is an <strong>NWC (Nostr Wallet Connect)</strong> connection — the modern, mobile-friendly way to use Zeus with your node. It connects directly through your Lightning domain, so no Tor or port forwarding is needed on your phone.</p>' +
-      '<div class="nwc-connect-steps">' +
-        '<div class="nwc-connect-step"><div class="nwc-step-num">1</div><div><strong>Download Zeus</strong> from the App Store or Google Play.</div></div>' +
-        '<div class="nwc-connect-step"><div class="nwc-step-num">2</div><div>Open Zeus and open the <strong>Wallets</strong> screen.</div></div>' +
-        '<div class="nwc-connect-step"><div class="nwc-step-num">3</div><div>Tap the <strong>+ (Add Wallet)</strong> button in the top-right corner.</div></div>' +
-        '<div class="nwc-connect-step"><div class="nwc-step-num">4</div><div>On <strong>Wallet Configuration</strong>, tap the <strong>scan icon</strong> in the top-right corner, then scan the QR code above.</div></div>' +
-        '<div class="nwc-connect-step"><div class="nwc-step-num">5</div><div>Zeus detects the NWC QR and fills in <strong>Nostr Wallet Connect</strong>. Review it, then tap <strong>Save Wallet Config</strong>.</div></div>' +
-      '</div>' +
-      '<div class="nwc-connect-note"><strong>💡 Note:</strong> This is <em>not</em> the same as the LND REST / Tor QR shown on your LND tile — that connects Zeus directly to your Lightning node for full admin control. NWC gives your wallet sandboxed, limited access for everyday spending.</div>' +
-    '</div>';
-    html += '<div class="matrix-form-actions">' +
-      '<button class="matrix-form-back" id="nwc-created-another-btn"' + (state.busy ? " disabled" : "") + '>Create Another Wallet</button>' +
-      '<button class="matrix-form-submit" id="nwc-created-continue-btn"' + (state.busy ? " disabled" : "") + '>I Saved This Secret</button>' +
-      '</div>';
-    host.innerHTML = html;
-    _attachCopyHandlers(host);
-    var continueBtn = document.getElementById("nwc-created-continue-btn");
-    if (continueBtn) {
-      continueBtn.addEventListener("click", async function() {
-        if (state.busy) return;
-        state.lastCreated = null;
-        state.view = "list";
-        await _nwcRefreshWallets();
-      });
-    }
-    var anotherBtn = document.getElementById("nwc-created-another-btn");
-    if (anotherBtn) {
-      anotherBtn.addEventListener("click", function() {
-        if (state.busy) return;
-        state.view = "create";
-        _nwcClearMessage();
-        _nwcRenderWalletState();
-      });
-    }
-    return;
-  }
-
-  if (state.view === "share" && state.shareWallet) {
-    var sw = state.shareWallet;
-    var swId = encodeURIComponent(String(sw.id || sw.pubkey || ""));
-    var swAddress = sw.lightning_address || ((sw.alias && state.domain) ? sw.alias + "@" + state.domain : "");
-    var pngUrl = "/api/nwc/wallets/" + swId + "/lnurl-qr.png";
-    var shareAddrId = "nwc-share-addr-" + Math.random().toString(36).substring(2, 8);
-    var shareLnurlId = "nwc-share-lnurl-" + Math.random().toString(36).substring(2, 8);
-    html += '<p class="svc-detail-desc">Share the Lightning Address for <strong>' + escHtml(sw.name || "Wallet") + '</strong>. This QR never expires — anyone can scan it with any Lightning wallet to send sats, as many times as they like.</p>' +
-      '<div class="creds-qr-wrap">' +
-        '<img class="creds-qr-img" src="' + pngUrl + '" alt="LNURL QR code for ' + escHtml(swAddress) + '">' +
-        '<div class="creds-qr-hint">Scan with any Lightning wallet to pay ' + escHtml(swAddress) + '</div>' +
-      '</div>' +
-      (swAddress
-        ? '<div class="creds-row"><div class="creds-label">Lightning Address</div><div class="creds-value-wrap"><div class="creds-value" id="' + shareAddrId + '">' + escHtml(swAddress) + '</div><button class="creds-copy-btn" data-target="' + shareAddrId + '">Copy</button></div></div>'
-        : "") +
-      '<div class="creds-row"><div class="creds-label">LNURL</div><div class="creds-value-wrap"><div class="creds-value nwc-lnurl-value" id="' + shareLnurlId + '">Loading…</div><button class="creds-copy-btn" data-target="' + shareLnurlId + '">Copy</button></div></div>' +
-      '<div class="nwc-share-actions">' +
-        '<button class="matrix-form-submit" id="nwc-share-dl-png-btn">⬇ Download PNG</button>' +
-        '<button class="matrix-form-back" id="nwc-share-dl-svg-btn">⬇ Download SVG</button>' +
-        '<button class="matrix-form-back" id="nwc-share-print-btn">🖨 Print…</button>' +
-        '<button class="matrix-form-back" id="nwc-share-back-btn">← Back</button>' +
-      '</div>' +
-      '<div class="creds-qr-hint nwc-share-formats-hint">PNG is ideal for websites and social posts. SVG stays sharp at any print size.</div>';
-    host.innerHTML = html;
-    _attachCopyHandlers(host);
-    apiFetch("/api/nwc/wallets/" + swId + "/lnurl").then(function(payload) {
-      var el = document.getElementById(shareLnurlId);
-      if (el) el.textContent = payload.lnurl || "Unavailable";
-    }).catch(function() {
-      var el = document.getElementById(shareLnurlId);
-      if (el) el.textContent = "Unavailable";
-    });
-    function _nwcShareDownload(url) {
-      var a = document.createElement("a");
-      a.href = url;
-      a.rel = "noopener";
-      document.body.appendChild(a);
-      a.click();
-      a.remove();
-    }
-    var dlPngBtn = document.getElementById("nwc-share-dl-png-btn");
-    if (dlPngBtn) dlPngBtn.addEventListener("click", function() { _nwcShareDownload(pngUrl + "?download=1"); });
-    var dlSvgBtn = document.getElementById("nwc-share-dl-svg-btn");
-    if (dlSvgBtn) dlSvgBtn.addEventListener("click", function() { _nwcShareDownload("/api/nwc/wallets/" + swId + "/lnurl-qr.svg?download=1"); });
-    var printBtn = document.getElementById("nwc-share-print-btn");
-    if (printBtn) printBtn.addEventListener("click", function() { window.open("/api/nwc/wallets/" + swId + "/lnurl-qr/print", "_blank", "noopener"); });
-    var shareBackBtn = document.getElementById("nwc-share-back-btn");
-    if (shareBackBtn) {
-      shareBackBtn.addEventListener("click", function() {
-        state.view = "list";
-        state.shareWallet = null;
-        _nwcClearMessage();
-        _nwcRenderWalletState();
-      });
-    }
-    return;
-  }
-
-  var canCreate = !!state.domain && !state.busy;
-  var walletCount = (state.wallets || []).length;
-  html += '<div class="nwc-toolbar">' +
-    '<div class="nwc-toolbar-count">' + (walletCount === 1 ? '1 wallet' : walletCount + ' wallets') + '</div>' +
-    '<div class="nwc-toolbar-actions">' +
-      '<button class="matrix-form-back nwc-toolbar-refresh" id="nwc-refresh-btn"' + (state.busy ? " disabled" : "") + '>↻ Refresh</button>' +
-      '<button class="matrix-action-btn" id="nwc-open-create-btn"' + (canCreate ? "" : " disabled") + '>➕ New Wallet</button>' +
-    '</div>' +
-  '</div>';
-  if (!state.domain) {
-    html += '<div class="nwc-domain-required">' +
-      '<strong>⚠ Lightning Address domain required</strong>' +
-      '<div class="nwc-domain-required-body">Set up a unique hostname such as <strong>lightning.yourdomain.com</strong> before creating wallets.</div>' +
-      '<button class="btn btn-primary nwc-domain-required-btn" id="nwc-domain-setup-link">⚙ Go to Service &amp; Setup</button>' +
-    '</div>';
-  }
-
-  if (!state.wallets || state.wallets.length === 0) {
-    html += '<div class="nwc-empty-state">' +
-      '<div class="nwc-empty-icon">⚡</div>' +
-      '<div class="nwc-empty-title">Ready to start spending</div>' +
-      '<p class="nwc-empty-desc">Create your first isolated wallet to connect to apps like Zeus (via NWC) or Nostr. Experience faster, more secure Lightning payments today.</p>' +
-      '</div>';
-    host.innerHTML = html;
-    _nwcWireDomainLink();
-    var openCreateBtn = document.getElementById("nwc-open-create-btn");
-    if (openCreateBtn) {
-      openCreateBtn.addEventListener("click", function() {
-        if (state.busy) return;
-        _nwcClearMessage();
-        state.view = "create";
-        _nwcRenderWalletState();
-      });
-    }
-    var refreshBtnEmpty = document.getElementById("nwc-refresh-btn");
-    if (refreshBtnEmpty) refreshBtnEmpty.addEventListener("click", _nwcRefreshWallets);
-    return;
-  }
-
-  html += '<div class="nwc-wallet-list">';
-  state.wallets.forEach(function(wallet) {
-    var id = wallet.id || wallet.pubkey || "";
-    var addressId = "nwc-wallet-addr-" + Math.random().toString(36).substring(2, 8);
-    var pending = Number(wallet.pending_transactions || 0);
-    html += '<div class="nwc-wallet-card">' +
-      '<div class="nwc-wallet-card-head">' +
-        '<div class="nwc-wallet-card-title">' + escHtml(wallet.name || "Wallet") + '</div>' +
-        '<div class="nwc-wallet-chips">' +
-          '<span class="nwc-wallet-chip nwc-wallet-chip--balance">' + escHtml(_nwcFormatSats(wallet.balance_sats)) + ' sats</span>' +
-          (pending > 0
-            ? '<span class="nwc-wallet-chip nwc-wallet-chip--pending" title="Pending transactions">⏳ ' + escHtml(String(pending)) + ' pending</span>'
-            : '') +
-        '</div>' +
-      '</div>' +
-      (wallet.lightning_address
-        ? '<div class="nwc-wallet-address">' +
-            '<div class="creds-label">Lightning Address</div>' +
-            '<div class="creds-value-wrap"><div class="creds-value" id="' + addressId + '">' + escHtml(wallet.lightning_address) + '</div>' +
-            '<button class="creds-copy-btn" data-target="' + addressId + '">Copy</button></div>' +
-          '</div>'
-        : '<div class="nwc-wallet-address"><div class="creds-label">Alias</div>' +
-            '<div class="creds-value-wrap"><div class="creds-value">' + escHtml(wallet.alias || "") + '</div></div></div>') +
-      '<div class="nwc-wallet-actions">' +
-        '<button class="matrix-action-btn nwc-wallet-action-btn" data-action="share" data-wallet-id="' + escHtml(id) + '"' + ((state.busy || !wallet.lightning_address) ? " disabled" : "") + '>⚡ Share QR</button>' +
-        '<button class="matrix-form-back nwc-wallet-action-btn" data-action="test" data-wallet-alias="' + escHtml(wallet.alias || "") + '"' + (state.busy ? " disabled" : "") + '>Verify</button>' +
-        '<span class="nwc-wallet-actions-spacer"></span>' +
-        '<button class="matrix-form-back nwc-wallet-action-btn nwc-wallet-danger-btn" data-action="drain" data-wallet-id="' + escHtml(id) + '"' + (state.busy ? " disabled" : "") + '>Drain</button>' +
-        '<button class="matrix-form-back nwc-wallet-action-btn nwc-wallet-danger-btn" data-action="delete" data-wallet-id="' + escHtml(id) + '"' + (state.busy ? " disabled" : "") + '>Delete</button>' +
-      '</div>' +
-    '</div>';
-  });
-  html += "</div>";
-  host.innerHTML = html;
-  _attachCopyHandlers(host);
-  _nwcWireDomainLink();
-
-  var createBtn = document.getElementById("nwc-open-create-btn");
-  if (createBtn) {
-    createBtn.addEventListener("click", function() {
-      if (state.busy) return;
-      _nwcClearMessage();
-      state.view = "create";
-      _nwcRenderWalletState();
-    });
-  }
-
-  var refreshBtn = document.getElementById("nwc-refresh-btn");
-  if (refreshBtn) refreshBtn.addEventListener("click", _nwcRefreshWallets);
-
-  host.querySelectorAll(".nwc-wallet-action-btn").forEach(function(btn) {
-    btn.addEventListener("click", function() {
-      var action = btn.getAttribute("data-action");
-      if (action === "share") _nwcOpenShare(btn.getAttribute("data-wallet-id"));
-      else if (action === "test") _nwcVerifyWallet(btn.getAttribute("data-wallet-alias"));
-      else if (action === "drain") _nwcDrainWallet(btn.getAttribute("data-wallet-id"));
-      else if (action === "delete") _nwcDeleteWallet(btn.getAttribute("data-wallet-id"));
-    });
-  });
-}
-
-function _nwcOpenShare(walletId) {
-  if (!_nwcModalState || _nwcModalState.busy || !walletId) return;
-  var wallet = null;
-  for (var i = 0; i < _nwcModalState.wallets.length; i++) {
-    var w = _nwcModalState.wallets[i];
-    if (String(w.id || w.pubkey || "") === String(walletId)) { wallet = w; break; }
-  }
-  if (!wallet) {
-    _nwcSetMessage("error", "Wallet connection not found.");
-    _nwcRenderWalletState();
-    return;
-  }
-  _nwcClearMessage();
-  _nwcModalState.shareWallet = wallet;
-  _nwcModalState.view = "share";
-  _nwcRenderWalletState();
-}
-
-async function _nwcRefreshWallets() {
-  if (!_nwcModalState) return;
-  var host = _nwcWalletSectionEl();
-  if (host) host.innerHTML = '<p class="creds-loading">Loading wallet connections…</p>';
-  try {
-    var payload = await apiFetch("/api/nwc/wallets");
-    _nwcModalState.wallets = Array.isArray(payload.wallets) ? payload.wallets : [];
-    _nwcModalState.domain = payload.domain || null;
-    if (_nwcModalState.view !== "create" && _nwcModalState.view !== "created" && _nwcModalState.view !== "share") {
-      _nwcModalState.view = _nwcModalState.wallets.length > 0 ? "list" : "empty";
-    }
-    _nwcRenderWalletState();
-  } catch (err) {
-    _nwcSetMessage("error", (err && err.message) ? err.message : "Could not load wallet connections.");
-    _nwcRenderWalletState();
-  }
-}
-
-function _nwcBusy(on) {
-  if (!_nwcModalState) return;
-  _nwcModalState.busy = !!on;
-}
-
-async function _nwcCreateWallet() {
-  if (!_nwcModalState || _nwcModalState.busy) return;
-  var nameEl = document.getElementById("nwc-wallet-name");
-  var aliasEl = document.getElementById("nwc-wallet-alias");
-  var presetEl = document.getElementById("nwc-wallet-preset");
-  var limitEl = document.getElementById("nwc-wallet-limit");
-  if (!nameEl || !aliasEl || !presetEl || !limitEl) return;
-
-  var name = (nameEl.value || "").trim();
-  var alias = (aliasEl.value || "").trim().toLowerCase();
-  var preset = presetEl.value || "receive_only";
-  var limitRaw = (limitEl.value || "").trim();
-  var limit = null;
-
-  _nwcModalState.createForm = {
-    name: name,
-    alias: alias,
-    access_preset: preset,
-    spending_limit_sats: limitRaw
-  };
-
-  if (!name) {
-    _nwcSetMessage("error", "Wallet name is required.");
-    _nwcRenderWalletState();
-    return;
-  }
-  if (!/^[a-z0-9][a-z0-9_-]{0,31}$/.test(alias)) {
-    _nwcSetMessage("error", 'Alias must start with a letter or number and use only lowercase letters, numbers, "_" or "-".');
-    _nwcRenderWalletState();
-    return;
-  }
-  if (preset === "send_receive_limited") {
-    limit = parseInt(limitRaw, 10);
-    if (!Number.isFinite(limit) || limit <= 0) {
-      _nwcSetMessage("error", "A positive spending limit is required for limited send access.");
-      _nwcRenderWalletState();
-      return;
-    }
-  }
-
-  _nwcBusy(true);
-  _nwcClearMessage();
-  _nwcRenderWalletState();
-  try {
-    var payload = await apiFetch("/api/nwc/wallets", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        name: name,
-        alias: alias,
-        access_preset: preset,
-        spending_limit_sats: preset === "send_receive_limited" ? limit : null
-      })
-    });
-    _nwcModalState.lastCreated = {
-      wallet: payload.wallet || null,
-      pairing_uri: payload.pairing_uri || "",
-      pairing_qrcode: payload.pairing_qrcode || "",
-      lightning_address: payload.lightning_address || null
-    };
-    _nwcModalState.view = "created";
-    _nwcSetMessage("success", "Wallet created. Save the one-time secret before you continue.");
-    _nwcBusy(false);
-    _nwcRenderWalletState();
-  } catch (err) {
-    _nwcBusy(false);
-    _nwcSetMessage("error", (err && err.message) ? err.message : "Failed to create wallet connection.");
-    _nwcRenderWalletState();
-  }
-}
-
-async function _nwcVerifyWallet(alias) {
-  if (!_nwcModalState || _nwcModalState.busy || !alias) return;
-  _nwcBusy(true);
-  _nwcClearMessage();
-  _nwcRenderWalletState();
-  try {
-    await apiFetch("/api/nwc/addresses/" + encodeURIComponent(alias) + "/test", { method: "POST" });
-    _nwcSetMessage("success", "Lightning Address verification succeeded for " + alias + ".");
-  } catch (err) {
-    _nwcSetMessage("error", (err && err.message) ? err.message : "Lightning Address verification failed.");
-  }
-  _nwcBusy(false);
-  _nwcRenderWalletState();
-}
-
-async function _nwcDrainWallet(walletId) {
-  if (!_nwcModalState || _nwcModalState.busy || !walletId) return;
-  if (!window.confirm("Drain this wallet connection now? This cannot be undone.")) return;
-  _nwcBusy(true);
-  _nwcClearMessage();
-  _nwcRenderWalletState();
-  try {
-    var resp = await apiFetch("/api/nwc/wallets/" + encodeURIComponent(walletId) + "/drain", { method: "POST" });
-    _nwcSetMessage("success", "Wallet drained (" + String(resp.drained_sats || 0) + " sats).");
-    _nwcBusy(false);
-    await _nwcRefreshWallets();
-  } catch (err) {
-    _nwcBusy(false);
-    _nwcSetMessage("error", (err && err.message) ? err.message : "Failed to drain wallet.");
-    _nwcRenderWalletState();
-  }
-}
-
-async function _nwcDeleteWallet(walletId) {
-  if (!_nwcModalState || _nwcModalState.busy || !walletId) return;
-  if (!window.confirm("Delete this wallet connection? This removes the wallet alias from Lightning Wallet Connections.")) return;
-  _nwcBusy(true);
-  _nwcClearMessage();
-  _nwcRenderWalletState();
-  try {
-    await apiFetch("/api/nwc/wallets/" + encodeURIComponent(walletId), { method: "DELETE" });
-    _nwcSetMessage("success", "Wallet connection deleted.");
-    _nwcBusy(false);
-    await _nwcRefreshWallets();
-  } catch (err) {
-    _nwcBusy(false);
-    _nwcSetMessage("error", (err && err.message) ? err.message : "Failed to delete wallet connection.");
-    _nwcRenderWalletState();
-  }
-}
-
-async function _nwcInitWalletFlow(unit, name, icon) {
-  _nwcModalState = {
-    unit: unit,
-    name: name,
-    icon: icon,
-    view: "empty",
-    wallets: [],
-    domain: null,
-    busy: false,
-    message: "",
-    messageKind: "",
-    lastCreated: null,
-    shareWallet: null,
-    createForm: {
-      name: "",
-      alias: "",
-      access_preset: "receive_only",
-      spending_limit_sats: ""
-    }
-  };
-  await _nwcRefreshWallets();
-}
-
 async function openServiceDetailModal(unit, name, icon) {
   if (!$credsModal) return;
-  var isNwc = _isNwcServiceUnit(unit);
-  _setCredsDialogWide(isNwc);
   if ($credsTitle) {
     $credsTitle.innerHTML = '';
     if (icon) {
@@ -653,38 +81,13 @@ async function openServiceDetailModal(unit, name, icon) {
     var url = "/api/service-detail/" + encodeURIComponent(unit);
     if (icon) url += "?icon=" + encodeURIComponent(icon);
     var data = await apiFetch(url);
-
-    // Append version badge next to title if version is detected
-    var serviceVersion = data.version || data.bitcoin_version || '';
-    if (serviceVersion && $credsTitle) {
-      var existingBadge = $credsTitle.querySelector(".creds-title-version-badge");
-      if (existingBadge) {
-        existingBadge.textContent = serviceVersion;
-      } else {
-        var badge = document.createElement("span");
-        badge.className = "creds-title-version-badge";
-        badge.textContent = serviceVersion;
-        $credsTitle.appendChild(badge);
-      }
-    }
-
-    // Two content buckets. For most services everything lands in `html` and is
-    // rendered as one column, exactly as before. For Lightning Wallet
-    // Connections the day-to-day wallet manager (html) is split away from the
-    // service plumbing — status, enable/disable, domain, ports, restart
-    // (setupHtml) — and the two are rendered as tabs so neither feels cramped.
     var html = "";
-    var setupHtml = "";
-    function addSetup(chunk) {
-      if (isNwc) setupHtml += chunk;
-      else html += chunk;
-    }
 
     // Section A: Description
     if (data.description) {
-      addSetup('<div class="svc-detail-section">' +
+      html += '<div class="svc-detail-section">' +
         '<p class="svc-detail-desc">' + escHtml(data.description) + '</p>' +
-        '</div>');
+        '</div>';
     }
 
     // Section B: Status
@@ -696,13 +99,13 @@ async function openServiceDetailModal(unit, name, icon) {
       : (data.health || data.status);
     var sc = statusClass(effectiveHealth);
     var st = statusText(effectiveHealth, effectiveEnabled);
-    addSetup('<div class="svc-detail-section">' +
+    html += '<div class="svc-detail-section">' +
       '<div class="svc-detail-section-title">Status</div>' +
       '<div class="svc-detail-status">' +
         '<span class="status-dot ' + sc + '"></span>' +
         '<span>' + escHtml(st) + '</span>' +
       '</div>' +
-      '</div>');
+      '</div>';
 
     // Section B2: BIP-110 live status (bip110 tile only)
     if (icon === 'bip110' && data.bip110) {
@@ -744,130 +147,83 @@ async function openServiceDetailModal(unit, name, icon) {
         domainActionHtml = '<button class="btn btn-primary svc-detail-domain-btn" id="svc-detail-reconfig-domain-btn">🔄 Reconfigure Domain</button>';
       }
 
-      addSetup('<div class="svc-detail-section">' +
+      html += '<div class="svc-detail-section">' +
         '<div class="svc-detail-section-title">Domain Diagnostic Checklist</div>' +
         stepsHtml +
         domainActionHtml +
-        '</div>');
+        '</div>';
 
-      if (data.router_ports && data.router_ports.length > 0) {
-        var trimmedInternalIp = data.internal_ip ? String(data.internal_ip).trim() : "";
-        addSetup('<div class="svc-detail-section">' +
-          '<div class="svc-detail-section-title">Ports to Forward in Your Router</div>' +
-          renderPortForwardGuideHtml(data.router_ports, {
-            internalIp: trimmedInternalIp || null,
-            tableClass: "svc-detail-port-table",
-            introClass: "svc-detail-port-note",
-            noteClass: "svc-detail-port-note",
-          }) +
-          '</div>');
+      if (unit === "livekit.service" && data.extra_ports && data.extra_ports.length > 0) {
+        var extraRows = "";
+        data.extra_ports.forEach(function(p) {
+          var statusIcon, statusClass2;
+          if (p.status === "listening") {
+            statusIcon = "✅ Open";
+            statusClass2 = "port-status-listening";
+          } else if (p.status === "firewall_open") {
+            statusIcon = "🟡 Firewall open";
+            statusClass2 = "port-status-open";
+          } else if (p.status === "closed") {
+            statusIcon = "❌ Closed";
+            statusClass2 = "port-status-closed";
+          } else {
+            statusIcon = "— Unknown";
+            statusClass2 = "port-status-unknown";
+          }
+          extraRows += '<tr>' +
+            '<td class="svc-detail-port-table-port">' + escHtml(p.port) + '</td>' +
+            '<td class="svc-detail-port-table-proto">' + escHtml(p.protocol) + '</td>' +
+            '<td class="svc-detail-port-table-desc">' + escHtml(p.description || "") + '</td>' +
+            '<td class="svc-detail-port-table-status ' + statusClass2 + '">' + statusIcon + '</td>' +
+            '</tr>';
+        });
+        html += '<div class="svc-detail-section">' +
+          '<div class="svc-detail-section-title">Step 4: Additional Ports</div>' +
+          '<table class="svc-detail-port-table">' +
+            '<thead><tr><th>Port</th><th>Protocol</th><th>Description</th><th>Status</th></tr></thead>' +
+            '<tbody>' + extraRows + '</tbody>' +
+          '</table>' +
+          '</div>';
       }
     } else if (data.port_statuses && data.port_statuses.length > 0) {
-      // Non-domain services (e.g. SSH): show what to forward, plus a short
-      // note if the service isn't actually listening on this computer yet.
-      var localInternalIp = data.internal_ip ? String(data.internal_ip).trim() : "";
-      var notListening = data.port_statuses.filter(function(p) {
-        return p.status === "closed";
+      // Non-domain services (SSH) keep local single-port checks.
+      var portTableRows = "";
+      data.port_statuses.forEach(function(p) {
+        var statusIcon, statusClass2;
+        if (p.status === "listening") {
+          statusIcon = "✅ Open";
+          statusClass2 = "port-status-listening";
+        } else if (p.status === "firewall_open") {
+          statusIcon = "🟡 Firewall open";
+          statusClass2 = "port-status-open";
+        } else if (p.status === "closed") {
+          statusIcon = "🔴 Closed";
+          statusClass2 = "port-status-closed";
+        } else {
+          statusIcon = "— Unknown";
+          statusClass2 = "port-status-unknown";
+        }
+        portTableRows += '<tr>' +
+          '<td class="svc-detail-port-table-port">' + escHtml(p.port) + '</td>' +
+          '<td class="svc-detail-port-table-proto">' + escHtml(p.protocol) + '</td>' +
+          '<td class="svc-detail-port-table-desc">' + escHtml(p.description || "") + '</td>' +
+          '<td class="svc-detail-port-table-status ' + statusClass2 + '">' + statusIcon + '</td>' +
+          '</tr>';
       });
-      var localNote = notListening.length
-        ? '<div class="svc-detail-port-note port-status-closed">' +
-            '⚠ Port ' + escHtml(notListening.map(function(p) { return p.port; }).join(", ")) +
-            ' is not open on this computer yet — enable the service below first, then forward it in your router.' +
-          '</div>'
-        : "";
       html += '<div class="svc-detail-section">' +
-        '<div class="svc-detail-section-title">Ports to Forward in Your Router</div>' +
-        '<div class="svc-detail-port-note">Only needed if you want to reach this service from <strong>outside</strong> your home network. On your local network it already works without any router changes.</div>' +
-        renderPortForwardGuideHtml(data.port_statuses, {
-          internalIp: localInternalIp || null,
-          tableClass: "svc-detail-port-table",
-          introClass: "svc-detail-port-note",
-          noteClass: "svc-detail-port-note",
-        }) +
-        localNote +
+        '<div class="svc-detail-section-title">Port Status</div>' +
+        '<table class="svc-detail-port-table">' +
+          '<thead><tr><th>Port</th><th>Protocol</th><th>Description</th><th>Status</th></tr></thead>' +
+          '<tbody>' + portTableRows + '</tbody>' +
+        '</table>' +
         '</div>';
     }
 
     // Section E: Credentials & Links
-    if (isNwc) {
-      if (effectiveEnabled || data.enabled) {
-        html += '<div class="nwc-tab-intro">' +
-            '<div class="nwc-intro-header">' +
-              '<div class="nwc-tab-intro-title">Lightning Wallet Connections</div>' +
-              '<p class="nwc-tab-intro-desc">Powerful, isolated wallets for your daily spending and modern apps.</p>' +
-            '</div>' +
-            '<div class="nwc-benefits-grid">' +
-              '<div class="nwc-benefit-item">' +
-                '<div class="nwc-benefit-icon">🛡️</div>' +
-                '<div class="nwc-benefit-content">' +
-                  '<strong>Isolated & Secure</strong>' +
-                  '<p>Create sandboxed wallets for quick spending while keeping your main node protected. Isolated access is faster than Tor and perfect for budgeting.</p>' +
-                '</div>' +
-              '</div>' +
-              '<div class="nwc-benefit-item">' +
-                '<div class="nwc-benefit-icon">🌐</div>' +
-                '<div class="nwc-benefit-content">' +
-                  '<strong>Modern Ecosystem</strong>' +
-                  '<p>Easily spend and receive bitcoin using LNURL and Nostr (NWC) across the growing ecosystem of decentralized apps.</p>' +
-                '</div>' +
-              '</div>' +
-              '<div class="nwc-benefit-item">' +
-                '<div class="nwc-benefit-icon">📱</div>' +
-                '<div class="nwc-benefit-content">' +
-                  '<strong>Zeus on the Go (via NWC)</strong>' +
-                  '<p>Connect Zeus to your wallet using NWC — no Tor, no port forwarding. Create a wallet below, scan the pairing QR, and start spending from your phone.</p>' +
-                '</div>' +
-              '</div>' +
-            '</div>' +
-          '</div>' +
-          '<div id="nwc-wallets-body"><p class="creds-loading">Loading wallets…</p></div>' +
-          '<details class="nwc-liquidity-details">' +
-            '<summary class="nwc-liquidity-summary">' +
-              '<span class="nwc-liquidity-icon">⚡</span>' +
-              '<span>' +
-                '<strong>Lightning Channel &amp; Liquidity Guide</strong>' +
-                '<span class="nwc-liquidity-subtitle">Why a brand-new node can\'t send or receive yet</span>' +
-              '</span>' +
-            '</summary>' +
-            '<div class="nwc-liquidity-guide-card">' +
-              '<p class="nwc-liquidity-body">' +
-                'Your wallets, pairing keys, and Lightning Address endpoints (like <code>name@yourdomain.com</code>) work the moment you create them. Moving actual bitcoin, though, needs a Lightning node with open channels.' +
-              '</p>' +
-              '<div class="nwc-liquidity-steps">' +
-                '<div class="nwc-liquidity-step">' +
-                  '<div class="step-num">1</div>' +
-                  '<div>' +
-                    '<strong>Outbound Liquidity (Sending)</strong>' +
-                    '<p class="nwc-liquidity-step-desc">Required so connected apps can pay invoices and send funds.</p>' +
-                  '</div>' +
-                '</div>' +
-                '<div class="nwc-liquidity-step">' +
-                  '<div class="step-num">2</div>' +
-                  '<div>' +
-                    '<strong>Inbound Liquidity (Receiving)</strong>' +
-                    '<p class="nwc-liquidity-step-desc">Required so your Lightning Address can receive payments from anyone.</p>' +
-                  '</div>' +
-                '</div>' +
-              '</div>' +
-              '<div class="nwc-liquidity-action">' +
-                '<p class="nwc-liquidity-analogy">💧 <strong>The Plumbing Analogy:</strong> Channels are two-way water pipes. To pour water in (receive) or pump it out (send), you need open channels with liquidity on the right side.</p>' +
-                '<button class="matrix-action-btn nwc-rtl-btn" id="nwc-open-rtl-btn">🚀 Open Ride The Lightning (RTL) to Manage Channels</button>' +
-              '</div>' +
-            '</div>' +
-          '</details>';
-      } else {
-        html += '<div class="nwc-disabled-state">' +
-          '<div class="nwc-disabled-icon">⚡</div>' +
-          '<div class="nwc-disabled-title">Lightning Wallet Connections is turned off</div>' +
-          '<p class="nwc-disabled-desc">Enable it on the <strong>Service &amp; Setup</strong> tab and rebuild, then come back here to create and manage wallets.</p>' +
-          '<button class="btn btn-primary" id="nwc-goto-setup-btn">⚙ Go to Service &amp; Setup</button>' +
-          '</div>';
-      }
-    } else if (data.has_credentials && data.credentials && data.credentials.length > 0) {
+    if (data.has_credentials && data.credentials && data.credentials.length > 0) {
       html += '<div class="svc-detail-section">' +
         '<div class="svc-detail-section-title">Credentials &amp; Access</div>' +
         _renderCredsHtml(data.credentials, unit) +
-        (unit === "zeus-connect-setup.service" ? _getZeusConnectGuideHtml() : "") +
         (unit === "matrix-synapse.service" ?
           '<hr class="matrix-actions-divider"><div class="matrix-actions-row">' +
             '<button class="matrix-action-btn" id="matrix-add-user-btn">➕ Add New User</button>' +
@@ -923,7 +279,7 @@ async function openServiceDetailModal(unit, name, icon) {
         conflictsHtml = '<div class="feature-conflict-warning">\u26A0 Mutually exclusive with: ' + escHtml(conflictNames.join(", ")) + '</div>';
       }
 
-      addSetup('<div class="svc-detail-section">' +
+      html += '<div class="svc-detail-section">' +
         '<div class="svc-detail-section-title">' + addonSectionTitle + '</div>' +
         '<p class="svc-detail-desc">' + escHtml(addonDesc) + '</p>' +
         conflictsHtml +
@@ -931,45 +287,20 @@ async function openServiceDetailModal(unit, name, icon) {
           '<span class="svc-detail-addon-status ' + addonStatusCls + '">' + addonStatusLabel + '</span>' +
           '<button class="' + addonBtnCls + '" id="svc-detail-addon-btn">' + escHtml(addonBtnLabel) + '</button>' +
         '</div>' +
-        '</div>');
+        '</div>';
     }
 
     if ((effectiveEnabled || data.enabled) && unit !== "phpfpm-nextcloud.service" && unit !== "phpfpm-wordpress.service") {
-      addSetup('<div class="svc-detail-section svc-detail-restart-section">' +
+      html += '<div class="svc-detail-section svc-detail-restart-section">' +
         '<div class="svc-detail-section-title">Troubleshooting</div>' +
         '<p class="svc-detail-desc">If you\'re experiencing issues with this service, try restarting it.</p>' +
         '<button class="btn btn-warning svc-detail-restart-btn" id="svc-detail-restart-btn">🔄 Restart Service</button>' +
         '<div class="svc-detail-restart-result" id="svc-detail-restart-result"></div>' +
-        '</div>');
-    }
-
-    if (isNwc) {
-      // Land on Setup when the service is off or the domain still needs
-      // configuring — otherwise the Wallets tab is the useful default.
-      var domainReady = !!data.domain;
-      var startTab = (effectiveEnabled || data.enabled) && domainReady ? "wallets" : "setup";
-      html = _nwcTabsShellHtml({
-        walletsHtml: html,
-        setupHtml: setupHtml,
-        statusDotClass: sc,
-        statusLabel: st,
-        domain: data.domain || null,
-        activeTab: startTab
-      });
+        '</div>';
     }
 
     $credsBody.innerHTML = html;
-    if (isNwc) _nwcWireTabs();
     _attachCopyHandlers($credsBody);
-    if (_isNwcServiceUnit(unit) && (effectiveEnabled || data.enabled)) {
-      await _nwcInitWalletFlow(unit, name, icon);
-      var nwcRtlBtn = document.getElementById("nwc-open-rtl-btn");
-      if (nwcRtlBtn) {
-        nwcRtlBtn.addEventListener("click", function() {
-          openServiceDetailModal("rtl.service", "Ride The Lightning", "rtl");
-        });
-      }
-    }
 
     if (unit === "matrix-synapse.service") {
       var addBtn = document.getElementById("matrix-add-user-btn");
@@ -1055,7 +386,6 @@ async function openServiceDetailModal(unit, name, icon) {
 
 async function openCredsModal(unit, name, icon) {
   if (!$credsModal) return;
-  _setCredsDialogWide(false);
   if ($credsTitle) {
     $credsTitle.innerHTML = '';
     if (icon) {
@@ -1085,9 +415,6 @@ async function openCredsModal(unit, name, icon) {
         '<button class="matrix-action-btn" id="matrix-change-pw-btn">🔑 Change Password</button>' +
         '</div>';
     }
-    if (unit === "zeus-connect-setup.service") {
-      html += _getZeusConnectGuideHtml();
-    }
     $credsBody.innerHTML = html;
     _attachCopyHandlers($credsBody);
     if (unit === "matrix-synapse.service") {

app/sovran_systemsos_web/static/js/state.js

@@ -49,9 +49,6 @@ const $btnSave        = document.getElementById("btn-save-report");
 const $btnCloseModal  = document.getElementById("btn-close-modal");
 
 const $rebootOverlay  = document.getElementById("reboot-overlay");
-const $rebootMainCard = document.getElementById("reboot-main-card");
-const $rebootErrorCard = document.getElementById("reboot-error-card");
-const $rebootSubmessage = document.getElementById("reboot-submessage");
 
 const $credsModal     = document.getElementById("creds-modal");
 const $credsTitle     = document.getElementById("creds-modal-title");
@@ -104,14 +101,5 @@ const $upgradeConfirmBtn  = document.getElementById("upgrade-confirm-btn");
 const $upgradeCancelBtn   = document.getElementById("upgrade-cancel-btn");
 const $upgradeCloseBtn    = document.getElementById("upgrade-close-btn");
 
-// Restart confirm dialog
-const $restartConfirmModal  = document.getElementById("restart-confirm-modal");
-const $restartConfirmOk     = document.getElementById("restart-confirm-ok-btn");
-const $restartConfirmCancel = document.getElementById("restart-confirm-cancel-btn");
-const $restartConflictBox   = document.getElementById("restart-conflict-box");
-
-// Header reboot button
-const $headerRebootBtn = document.getElementById("btn-header-reboot");
-
 // System status banner
 // (removed — health is now shown per-tile via the composite health field)

app/sovran_systemsos_web/static/js/support.js

@@ -473,99 +473,45 @@ function renderBackupReady(drives) {
     ].join("");
   }
 
-  // ── Role-aware backup description ─────────────────────────────
-  // Desktop Only systems run no server or Bitcoin services and have no
-  // internal second drive, so the backup mirrors only the NixOS configuration
-  // and home directory. nix-bitcoin secrets, /var/lib system service data,
-  // and the database/blockchain caveats apply only to the Node and
-  // Server + Desktop roles.
-  var isDesktopOnly = (_currentRole === "desktop");
-
-  var introHtml;
-  if (isDesktopOnly) {
-    introHtml = [
-      '<div class="support-wallet-box support-wallet-protected" style="margin-bottom:16px;">',
-        '<p class="support-wallet-desc">',
-          'This manual backup lets you create a copy of your system on an external USB drive \u2014 ',
-          'storing your data in a second location, outside the computer, for maximum protection ',
-          'against hardware failure or physical damage.',
-        '</p>',
-      '</div>',
-    ].join("");
-  } else {
-    introHtml = [
-      '<div class="support-wallet-box support-wallet-protected" style="margin-bottom:16px;">',
-        '<p class="support-wallet-desc">',
-          'Your Sovran Pro already backs up your data automatically to its internal second drive. ',
-          'This manual backup lets you create an additional copy on an external USB drive \u2014 ',
-          'storing your data in a third location, outside the computer, for maximum protection ',
-          'against hardware failure or physical damage.',
-        '</p>',
-      '</div>',
-    ].join("");
-  }
-
-  var backupItemsHtml;
-  if (isDesktopOnly) {
-    backupItemsHtml = [
-      '<li>NixOS configuration (<code>/etc/nixos</code>)</li>',
-      '<li>Home directory (<code>/home</code>)</li>',
-    ].join("");
-  } else {
-    backupItemsHtml = [
-      '<li>NixOS configuration (<code>/etc/nixos</code>)</li>',
-      '<li>nix-bitcoin secrets (<code>/etc/nix-bitcoin-secrets</code>)</li>',
-      '<li>System service data (<code>/var/lib</code>) — excluding databases and blockchain data (see note below)</li>',
-      '<li>Home directory (<code>/home</code>)</li>',
-    ].join("");
-  }
-
-  // The database/blockchain caveat is only relevant when server services exist.
-  var dbNoteHtml = "";
-  if (!isDesktopOnly) {
-    dbNoteHtml = [
-      '<div class="support-wallet-box support-wallet-warning">',
-        '<div class="support-wallet-header">',
-          '<span class="support-wallet-icon">\u2139\ufe0f</span>',
-          '<span class="support-wallet-title">Database and Blockchain Data</span>',
-        '</div>',
-        '<p class="support-wallet-desc">Application databases stored in PostgreSQL or MariaDB/MySQL are <strong>not included</strong> in Manual Backup. Bitcoin blockchain and Electrs index data are also excluded (they are stored on the internal second drive). If you use Nextcloud, Matrix, or other database-backed applications, back up those databases separately with their native tools.</p>',
-      '</div>',
-    ].join("");
-  }
-
   $supportBody.innerHTML = [
     '<div class="support-section">',
     '<div class="support-icon-big">\ud83d\udcbe</div>',
     '<h3 class="support-heading">Manual Backup</h3>',
 
-    introHtml,
+    '<div class="support-wallet-box support-wallet-protected" style="margin-bottom:16px;">',
+      '<p class="support-wallet-desc">',
+        'Your Sovran Pro already backs up your data automatically to its internal second drive. ',
+        'This manual backup lets you create an additional copy on an external USB drive \u2014 ',
+        'storing your data in a third location, outside the computer, for maximum protection ',
+        'against hardware failure or physical damage.',
+      '</p>',
+    '</div>',
 
     '<div class="support-steps">',
       '<div class="support-steps-title">Requirements</div>',
       '<ol class="support-backup-steps">',
         '<li>USB hard drive plugged into one of the open USB ports on your Sovran Pro</li>',
-        '<li>Enough free space for your data (the backup checks this before starting)</li>',
-        '<li>Drive must be formatted as <strong>ext4</strong> (a Linux filesystem). Drives with exFAT, FAT32, or NTFS are not supported. To format a drive as ext4, use a Linux tool such as GParted or <code>mkfs.ext4</code> — note that formatting erases all data on the drive.</li>',
-        '<li>The drive is intended for Linux/Sovran recovery. It may not be directly readable by Windows or macOS without additional software.</li>',
+        '<li>At least 500 GB of free space on the drive</li>',
+        '<li>Drive must be formatted as <strong>exFAT</strong></li>',
       '</ol>',
     '</div>',
 
     '<div class="support-steps">',
       '<div class="support-steps-title">What gets backed up</div>',
       '<ol class="support-backup-steps">',
-        backupItemsHtml,
+        '<li>NixOS configuration (<code>/etc/nixos</code>)</li>',
+        '<li>nix-bitcoin secrets (<code>/etc/nix-bitcoin-secrets</code>)</li>',
+        '<li>System service data (<code>/var/lib</code>) including Vaultwarden, bitcoind, LND, sovran-hub, domains, and secrets</li>',
+        '<li>Home directory (<code>/home</code>)</li>',
       '</ol>',
     '</div>',
 
-    dbNoteHtml,
-
-    '<div class="support-wallet-box support-wallet-protected">',
+    '<div class="support-wallet-box support-wallet-warning">',
       '<div class="support-wallet-header">',
         '<span class="support-wallet-icon">\u23f1\ufe0f</span>',
         '<span class="support-wallet-title">Time Estimate</span>',
       '</div>',
-      '<p class="support-wallet-desc">The first backup may take a while depending on how much data you have. Later backups are much faster because only changed or new files are copied. Files are stored directly on the drive and can be browsed without any special software.</p>',
+      '<p class="support-wallet-desc">This backup can take <strong>up to 4 hours</strong> depending on the amount of data stored on your Sovran Pro and the speed of your external hard drive. Be patient\u2026</p>',
     '</div>',
 
     driveSelector,
@@ -638,10 +584,9 @@ async function pollBackupStatus() {
       logDiv.scrollTop = logDiv.scrollHeight;
     }
     _backupLogOffset = data.offset;
-    const result = (data.result || "").toLowerCase();
-    if (result === "success" || result === "failed") {
+    if (!data.running) {
       stopBackupPoll();
-      renderBackupDone(result === "success");
+      renderBackupDone(data.result === "success");
     }
   } catch (_) {}
 }
@@ -673,7 +618,7 @@ function renderBackupDone(success) {
       '<div class="support-section">',
       '<div class="support-icon-big">\u26a0\ufe0f</div>',
       '<h3 class="support-heading">Backup Failed</h3>',
-      '<p class="support-desc">The backup did not complete successfully. Please check that the USB drive is still connected, has enough free space, and is formatted as ext4. Then try again.</p>',
+      '<p class="support-desc">The backup did not complete successfully. Please check that the USB drive is still connected, has enough free space, and is formatted as exFAT. Then try again.</p>',
       '<div class="modal-log" id="backup-log-fail" style="text-align:left;"></div>',
       '<button class="btn support-btn-done" id="btn-backup-close">Close</button>',
       '</div>',

app/sovran_systemsos_web/static/js/tiles.js

@@ -156,10 +156,13 @@ function buildTile(svc) {
     var pct = Math.round((svc.sync_progress || 0) * 100);
     var id = tileId(svc);
     var eta = _calcBtcEta(id, svc.sync_progress || 0);
+    var ver = svc.version || svc.bitcoin_version || '';
+    var versionLabel = ver ? '<div class="tile-version">' + escHtml(ver) + '</div>' : '';
     tile.innerHTML =
       '<img class="tile-icon" src="/static/icons/' + escHtml(svc.icon) + '.svg" alt="' + escHtml(svc.name) + '" onerror="this.style.display=\'none\';this.nextElementSibling.style.display=\'flex\'">' +
       '<div class="tile-icon-fallback" style="display:none">?</div>' +
       '<div class="tile-name">' + escHtml(svc.name) + '</div>' +
+      versionLabel +
       '<div class="tile-sync-container">' +
         '<div class="tile-sync-label">\u23F3 Syncing Timechain</div>' +
         '<div class="tile-sync-bar-row">' +
@@ -175,8 +178,10 @@ function buildTile(svc) {
     return tile;
   }
 
+  var ver = svc.version || svc.bitcoin_version || '';
+  var versionLabel = ver ? '<div class="tile-version">' + escHtml(ver) + '</div>' : '';
   var bip110Badge = (svc.icon === 'bip110') ? _renderBip110Badge(svc.bip110) : '';
-  tile.innerHTML = '<img class="tile-icon" src="/static/icons/' + escHtml(svc.icon) + '.svg" alt="' + escHtml(svc.name) + '" onerror="this.style.display=\'none\';this.nextElementSibling.style.display=\'flex\'"><div class="tile-icon-fallback" style="display:none">?</div><div class="tile-name">' + escHtml(svc.name) + '</div>' + bip110Badge + '<div class="tile-status"><span class="status-dot ' + sc + '"></span><span class="status-text">' + st + '</span></div>';
+  tile.innerHTML = '<img class="tile-icon" src="/static/icons/' + escHtml(svc.icon) + '.svg" alt="' + escHtml(svc.name) + '" onerror="this.style.display=\'none\';this.nextElementSibling.style.display=\'flex\'"><div class="tile-icon-fallback" style="display:none">?</div><div class="tile-name">' + escHtml(svc.name) + '</div>' + versionLabel + bip110Badge + '<div class="tile-status"><span class="status-dot ' + sc + '"></span><span class="status-text">' + st + '</span></div>';
 
   tile.style.cursor = "pointer";
   tile.addEventListener("click", function() {
@@ -230,6 +235,22 @@ function updateTiles(services) {
       if (fill) fill.style.width = pct + "%";
       if (pctEl) pctEl.textContent = pct + "%";
       if (etaEl) etaEl.textContent = etaText;
+      // Update or insert version label
+      var syncVer = svc.version || svc.bitcoin_version || '';
+      if (syncVer) {
+        var syncVerEl = tile.querySelector(".tile-version");
+        if (syncVerEl) {
+          syncVerEl.textContent = syncVer;
+        } else {
+          var syncNameEl = tile.querySelector(".tile-name");
+          if (syncNameEl) {
+            var newSyncVerEl = document.createElement("div");
+            newSyncVerEl.className = "tile-version";
+            newSyncVerEl.textContent = syncVer;
+            syncNameEl.insertAdjacentElement("afterend", newSyncVerEl);
+          }
+        }
+      }
     } else {
       // IBD finished or not syncing — if tile had sync layout rebuild it normally
       if (tile.querySelector(".tile-sync-container")) {
@@ -244,6 +265,22 @@ function updateTiles(services) {
       var text = tile.querySelector(".status-text");
       if (dot) dot.className = "status-dot " + sc;
       if (text) text.textContent = st;
+      // Update or insert version label for all service tiles
+      var tileVer = svc.version || svc.bitcoin_version || '';
+      if (tileVer) {
+        var verEl = tile.querySelector(".tile-version");
+        if (verEl) {
+          verEl.textContent = tileVer;
+        } else {
+          var nameEl = tile.querySelector(".tile-name");
+          if (nameEl) {
+            var newVerEl = document.createElement("div");
+            newVerEl.className = "tile-version";
+            newVerEl.textContent = tileVer;
+            nameEl.insertAdjacentElement("afterend", newVerEl);
+          }
+        }
+      }
       // Update BIP-110 badge for bip110 tiles
       if (svc.icon === 'bip110') {
         var badgeHtml = _renderBip110Badge(svc.bip110);
@@ -253,8 +290,8 @@ function updateTiles(services) {
           var newBadge = _firstElementFromHtml(badgeHtml);
           if (newBadge) { badgeEl.replaceWith(newBadge); } else { badgeEl.remove(); }
         } else if (badgeHtml) {
-          // Insert badge after the service name
-          var anchorEl = tile.querySelector(".tile-name");
+          // Insert badge after version label (or after tile-name if no version)
+          var anchorEl = tile.querySelector(".tile-version") || tile.querySelector(".tile-name");
           if (anchorEl) {
             var newBadgeEl = _firstElementFromHtml(badgeHtml);
             if (newBadgeEl) anchorEl.insertAdjacentElement("afterend", newBadgeEl);

app/sovran_systemsos_web/static/js/update.js

@@ -154,7 +154,7 @@ function onUpdateDone(result) {
     if ($modalStatus) $modalStatus.textContent = "✓ Update complete";
     if ($btnReboot) $btnReboot.style.display = "inline-flex";
   } else if (result === "reboot_required") {
-    if ($modalStatus) $modalStatus.textContent = "✓ Update complete — restart required";
+    if ($modalStatus) $modalStatus.textContent = "✓ Update complete — reboot required";
     if ($btnReboot) $btnReboot.style.display = "inline-flex";
   } else {
     if ($modalStatus) $modalStatus.textContent = "✗ Update failed";
@@ -179,50 +179,23 @@ function saveErrorReport() {
 
 var _rebootStartTime = 0;
 var _serverWentDown = false;
-var _rebootFailed = false;
-
-function _setRebootStatus(msg) {
-  if ($rebootSubmessage) $rebootSubmessage.textContent = msg;
-}
 
 function doReboot() {
   if ($modal) $modal.classList.remove("open");
   if ($rebuildModal) $rebuildModal.classList.remove("open");
   stopUpdatePoll();
   stopRebuildPoll();
-  // Reset overlay to main card
-  if ($rebootMainCard) $rebootMainCard.style.display = "";
-  if ($rebootErrorCard) $rebootErrorCard.style.display = "none";
-  _setRebootStatus("Sending restart request\u2026");
   if ($rebootOverlay) $rebootOverlay.classList.add("visible");
   _rebootStartTime = Date.now();
   _serverWentDown = false;
-  _rebootFailed = false;
   var rebootCtrl = new AbortController();
   setTimeout(function() { rebootCtrl.abort(); }, REBOOT_REQUEST_TIMEOUT);
-  fetch("/api/reboot", { method: "POST", signal: rebootCtrl.signal })
-    .then(function(res) {
-      if (!res.ok) {
-        // Definitive HTTP error — server rejected the request before going down
-        _rebootFailed = true;
-        if ($rebootMainCard) $rebootMainCard.style.display = "none";
-        if ($rebootErrorCard) $rebootErrorCard.style.display = "";
-        // Leave overlay visible so the error card is shown
-      }
-      // HTTP 2xx: request accepted, proceed with polling
-    })
-    .catch(function() {
-      // Connection dropped or request aborted — the server is likely already going
-      // down as part of the restart. Treat as success and continue polling.
-    });
+  fetch("/api/reboot", { method: "POST", signal: rebootCtrl.signal }).catch(function() {});
   // Wait before the first check — NixOS shutdown after an update can take 20-40s
   setTimeout(waitForServerReboot, REBOOT_INITIAL_DELAY);
 }
 
 function waitForServerReboot() {
-  if (_rebootFailed) return;
-  // Update status on first check (server hasn't gone down yet)
-  if (!_serverWentDown) _setRebootStatus("Waiting for the computer to shut down\u2026");
   var controller = new AbortController();
   var timeoutId = setTimeout(function() { controller.abort(); }, REBOOT_FETCH_TIMEOUT);
 
@@ -232,23 +205,18 @@ function waitForServerReboot() {
       if (_serverWentDown) {
         // Server is responding after having been down — reboot is complete.
         // Any response (even 401/500) means the server process is back.
-        _setRebootStatus("System is back online. Reconnecting\u2026");
         window.location.reload();
       } else if ((Date.now() - _rebootStartTime) < 90000) {
         // Server still responding but hasn't gone down yet — keep waiting
         setTimeout(waitForServerReboot, REBOOT_CHECK_INTERVAL);
       } else {
         // Been over 90 seconds and server is responding — just reload
-        _setRebootStatus("System is back online. Reconnecting\u2026");
         window.location.reload();
       }
     })
     .catch(function() {
       clearTimeout(timeoutId);
-      if (!_serverWentDown) {
-        _serverWentDown = true;
-        _setRebootStatus("The computer is restarting\u2026");
-      }
+      _serverWentDown = true;
       setTimeout(waitForServerReboot, REBOOT_CHECK_INTERVAL);
     });
 }

app/sovran_systemsos_web/static/onboarding.js

@@ -1,16 +1,16 @@
 /* Sovran_SystemsOS Hub — First-Boot Onboarding Wizard
-   Drives the 4-step post-install setup flow. */
+   Drives the 5-step post-install setup flow. */
 "use strict";
 
 // ── Constants ─────────────────────────────────────────────────────
 
-const TOTAL_STEPS = 4;
+const TOTAL_STEPS = 5;
 
-// Steps to skip per role (step 3 involves domain setup)
+// Steps to skip per role (steps 3 and 4 involve domain/port setup)
 // Step 2 (timezone/locale) is NEVER skipped — all roles need it.
 const ROLE_SKIP_STEPS = {
-  "desktop": [3],
-  "node":    [3],
+  "desktop": [3, 4],
+  "node":    [3, 4],
 };
 
 // ── Role state (loaded at init) ───────────────────────────────────
@@ -66,7 +66,7 @@ function setStatus(elId, msg, type) {
   el.className = "onboarding-save-status" + (type ? " onboarding-save-status--" + type : "");
 }
 
-function updateCompleteChecklist() {
+function updateStep5Checklist() {
   var checklist = document.getElementById("onboarding-checklist");
   if (!checklist) return;
   var existing = document.getElementById("onboarding-migration-check");
@@ -135,7 +135,8 @@ function showStep(step) {
   // Lazy-load step content
   if (step === 2) loadStep2();
   if (step === 3) loadStep3();
-  // Step 4 (Complete) is static — no lazy-load needed
+  if (step === 4) loadStep4();
+  // Step 5 (Complete) is static — no lazy-load needed
 }
 
 // Return the next step number, skipping over role-excluded steps
@@ -318,26 +319,21 @@ async function loadStep3() {
   if (!body) return;
 
   try {
-    // Fetch services and domains in parallel (network info is best-effort below)
+    // Fetch services, domains, and network info in parallel
     var results = await Promise.all([
       apiFetch("/api/services"),
       apiFetch("/api/domains/status"),
+      apiFetch("/api/network"),
     ]);
     _servicesData = results[0];
     _domainsData  = results[1];
+    var networkData = results[2];
   } catch (err) {
     body.innerHTML = '<p class="onboarding-error">⚠ Could not load service data: ' + escHtml(err.message) + '</p>';
     return;
   }
 
-  // Best-effort internal IP for the router note — never blocks this step
-  var internalIp = "";
-  try {
-    var networkData = await apiFetch("/api/network");
-    if (networkData && networkData.internal_ip && networkData.internal_ip !== "unavailable") {
-      internalIp = String(networkData.internal_ip).trim();
-    }
-  } catch (_) {}
+  var externalIp = (networkData && networkData.external_ip) || "Unknown (could not retrieve)";
 
   // Build set of enabled service units
   var enabledUnits = new Set();
@@ -350,35 +346,26 @@ async function loadStep3() {
     return enabledUnits.has(d.unit);
   });
 
-  var domainValues = (_domainsData && _domainsData.domains) || {};
-
   var html = "";
 
   if (relevantDomains.length === 0) {
     html += '<p class="onboarding-body-text">No domain-based services are enabled for your role. You can skip this step.</p>';
   } else {
-    // Shared instructions (single source of truth: static/js/domain-prereqs.js) —
-    // identical wording to the feature-enable domain modal shown for NWC,
-    // BTCPay Server, and every other domain-based feature, in every role.
     html += '<div class="onboarding-port-warn" style="margin-bottom:16px;">'
-      + renderDomainNeedsHtml({ serviceName: null, hostExample: "call" })
-      + renderNjallaStepsHtml({ hostExample: "call", pasteHint: "next to its service below" })
+      + '<strong>Before you continue:</strong>'
+      + '<ol style="margin:8px 0 0 16px; padding:0; line-height:1.7;">'
+      + '<li>Create an account at <a href="https://njal.la" target="_blank" style="color:var(--accent-color);">https://njal.la</a></li>'
+      + '<li>Purchase a new domain on Njal.la, or create a subdomain from a domain you already own. Tip: Subdomains are free to create — you only need to purchase one domain, and you can add as many subdomains as you like.</li>'
+      + '<li>In the Njal.la web interface, create a <strong>Dynamic</strong> record pointing to this machine\'s external IP address:<br>'
+      + '<span style="display:inline-block;margin-top:4px;padding:4px 12px;background:var(--card-color);border:1px solid var(--border-color);border-radius:6px;font-family:monospace;font-size:1.1em;font-weight:700;">' + escHtml(externalIp) + '</span></li>'
+      + '<li>Njal.la will give you a curl command like:<br>'
+      + '<code style="font-size:0.8em;">curl "https://njal.la/update/?h=sub.domain.com&amp;k=abc123&amp;auto"</code></li>'
+      + '<li>Enter the subdomain and paste that curl command below for each service</li>'
+      + '</ol>'
       + '</div>';
-    html += '<p class="onboarding-hint">Enter each service\'s full domain — a subdomain (e.g. <code>call.yourdomain.com</code>) or a separate domain (e.g. <code>call.com</code>) — and its Njal.la DDNS curl command.</p>';
-
-    // Router note (the same wording is shown again, per-service, whenever a
-    // domain-based feature is enabled, and lives on each service tile afterwards)
-    html += '<div class="onboarding-port-warn" style="margin-bottom:16px;">'
-      + renderRouterPortsHtml({
-          internalIp: internalIp,
-          plural: true,
-          includeSsh: true,
-          extraNote: "Element Call needs a few extra ports (some UDP), and you’ll be shown exactly which when you enable it.",
-        })
-      + '</div>';
-
+    html += '<p class="onboarding-hint">Enter each fully-qualified subdomain (e.g. <code>matrix.yourdomain.com</code>) and its Njal.la DDNS curl command.</p>';
     relevantDomains.forEach(function(d) {
-      var currentVal = domainValues[d.name] || "";
+      var currentVal = (_domainsData && _domainsData[d.name]) || "";
       html += '<div class="onboarding-domain-group">';
       html += '<label class="onboarding-domain-label">' + escHtml(d.label) + '</label>';
       html += '<input class="onboarding-domain-input domain-field-input" type="text" id="domain-input-' + escHtml(d.name) + '" data-domain="' + escHtml(d.name) + '" placeholder="e.g. ' + escHtml(d.name) + '.yourdomain.com" value="' + escHtml(currentVal) + '" />';
@@ -392,7 +379,7 @@ async function loadStep3() {
   }
 
   // SSL email section
-  var emailVal = domainValues["sslemail"] || "";
+  var emailVal = (_domainsData && _domainsData["sslemail"]) || "";
   html += '<div class="onboarding-domain-group onboarding-domain-group--email">';
   html += '<label class="onboarding-domain-label">📧 SSL Certificate Email</label>';
   html += '<p class="onboarding-hint onboarding-hint--inline">Let\'s Encrypt uses this for certificate expiry notifications.</p>';
@@ -520,10 +507,94 @@ async function saveStep3() {
   return true;
 }
 
-// ── Step 4: Complete ──────────────────────────────────────────────
+// ── Step 4: Port Forwarding ───────────────────────────────────────
+
+async function loadStep4() {
+  var body = document.getElementById("step-4-body");
+  if (!body) return;
+  body.innerHTML = '<p class="onboarding-loading">Checking ports…</p>';
+
+  var networkData = null;
+
+  try {
+    networkData = await apiFetch("/api/network");
+  } catch (err) {
+    body.innerHTML = '<p class="onboarding-error">⚠ Could not load network data: ' + escHtml(err.message) + '</p>';
+    return;
+  }
+
+  var internalIp = (networkData && networkData.internal_ip) || "unknown";
+
+  var ip = escHtml(internalIp);
+
+  var html = '<p class="onboarding-port-note" style="margin-bottom:14px;">'
+    + '⚠ <strong>Each port only needs to be forwarded once — all services share the same ports.</strong>'
+    + '</p>';
+
+  html += '<div class="onboarding-port-ip">';
+  html += '  <span class="onboarding-port-ip-label">Forward ports to this machine\'s internal IP:</span>';
+  html += '  <span class="port-req-internal-ip">' + ip + '</span>';
+  html += '</div>';
+
+  // Required ports table
+  html += '<div class="onboarding-port-section" style="margin-bottom:20px;">';
+  html += '<div class="onboarding-port-section-title" style="font-weight:700;margin-bottom:8px;">Required Ports — open these on your router:</div>';
+  html += '<table class="onboarding-port-table">';
+  html += '<thead><tr><th>Port</th><th>Protocol</th><th>Forward&nbsp;to</th><th>Purpose</th></tr></thead>';
+  html += '<tbody>';
+  html += '<tr><td class="port-req-port">80</td><td class="port-req-proto">TCP</td><td class="port-req-internal-ip">' + ip + '</td><td class="port-req-desc">HTTP</td></tr>';
+  html += '<tr><td class="port-req-port">443</td><td class="port-req-proto">TCP</td><td class="port-req-internal-ip">' + ip + '</td><td class="port-req-desc">HTTPS</td></tr>';
+  html += '<tr><td class="port-req-port">22</td><td class="port-req-proto">TCP</td><td class="port-req-internal-ip">' + ip + '</td><td class="port-req-desc">SSH Remote Access</td></tr>';
+  html += '</tbody></table>';
+  html += '</div>';
+
+  // Optional ports table
+  html += '<div class="onboarding-port-section" style="margin-bottom:20px;">';
+  html += '<div class="onboarding-port-section-title" style="font-weight:700;margin-bottom:4px;">Optional — Only needed if you enable Element Calling:</div>';
+  html += '<div style="font-size:0.88em;margin-bottom:8px;color:var(--color-text-muted,#888);">These 5 additional port openings are required on top of the 3 required ports above.</div>';
+  html += '<table class="onboarding-port-table">';
+  html += '<thead><tr><th>Port</th><th>Protocol</th><th>Forward&nbsp;to</th><th>Purpose</th></tr></thead>';
+  html += '<tbody>';
+  html += '<tr><td class="port-req-port">7881</td><td class="port-req-proto">TCP</td><td class="port-req-internal-ip">' + ip + '</td><td class="port-req-desc">LiveKit WebRTC signalling</td></tr>';
+  html += '<tr><td class="port-req-port">7882</td><td class="port-req-proto">UDP</td><td class="port-req-internal-ip">' + ip + '</td><td class="port-req-desc">LiveKit media (UDP mux)</td></tr>';
+  html += '<tr><td class="port-req-port">5349</td><td class="port-req-proto">TCP</td><td class="port-req-internal-ip">' + ip + '</td><td class="port-req-desc">TURN over TLS</td></tr>';
+  html += '<tr><td class="port-req-port">3478</td><td class="port-req-proto">UDP</td><td class="port-req-internal-ip">' + ip + '</td><td class="port-req-desc">TURN (STUN/relay)</td></tr>';
+  html += '<tr><td class="port-req-port">30000–40000</td><td class="port-req-proto">TCP &amp; UDP</td><td class="port-req-internal-ip">' + ip + '</td><td class="port-req-desc">TURN relay (WebRTC)</td></tr>';
+  html += '</tbody></table>';
+  html += '<div style="font-size:0.85em;margin-top:6px;color:var(--color-text-muted,#888);">ℹ The <strong>30000–40000</strong> range is a single forwarding rule — just set its protocol to <strong>both TCP and UDP</strong> (often shown as "Both" or "TCP/UDP" on your router).</div>';
+  html += '</div>';
+
+  // Totals
+  html += '<div class="onboarding-port-totals">';
+  html += '<strong>Total port openings: 3</strong> (without Element Calling)<br>';
+  html += '<strong>Total port openings: 8</strong> (with Element Calling — 3 required + 5 optional)';
+  html += '</div>';
+
+  html += '<div class="onboarding-port-warn" style="margin-bottom:16px;">'
+    + '⚠ <strong>Ports 80 and 443 must be forwarded first.</strong> '
+    + 'Caddy uses these to obtain SSL certificates from Let\'s Encrypt. '
+    + 'If they are closed, HTTPS will not work and your services will be unreachable from outside your network.'
+    + '</div>';
+
+  html += '<details class="onboarding-port-details" style="margin-bottom:16px;">'
+    + '<summary class="onboarding-port-details-summary">How to set up port forwarding</summary>'
+    + '<ol style="margin:12px 0 0 16px; padding:0; line-height:1.8;">'
+    + '<li>Open your router\'s admin panel — usually <code>http://192.168.1.1</code> or <code>http://192.168.0.1</code></li>'
+    + '<li>Look for <strong>"Port Forwarding"</strong>, <strong>"NAT"</strong>, or <strong>"Virtual Server"</strong> in the settings</li>'
+    + '<li>Create a new rule for each port listed above</li>'
+    + '<li>Set the destination/internal IP to <strong>' + ip + '</strong></li>'
+    + '<li>Set both internal and external port to the same number</li>'
+    + '<li>Save and apply changes</li>'
+    + '</ol>'
+    + '</details>';
+
+  body.innerHTML = html;
+}
+
+// ── Step 5: Complete ──────────────────────────────────────────────
 
 async function completeOnboarding() {
-  var btn = document.getElementById("step-4-finish");
+  var btn = document.getElementById("step-5-finish");
   if (btn) { btn.disabled = true; btn.textContent = "Finishing…"; }
 
   try {
@@ -546,7 +617,7 @@ function wireNavButtons() {
     try {
       await apiFetch("/api/migration/password-acknowledge", { method: "POST" });
       _migrationOccurred = true;
-      updateCompleteChecklist();
+      updateStep5Checklist();
       showStep1FromMigration();
     } catch (err) {
       setStatus("migration-password-status", "⚠ " + err.message, "error");
@@ -582,9 +653,13 @@ function wireNavButtons() {
     showStep(nextStep(3));
   });
 
-  // Step 4: finish
-  var s4finish = document.getElementById("step-4-finish");
-  if (s4finish) s4finish.addEventListener("click", completeOnboarding);
+  // Step 4 → 5 (port forwarding — no save needed)
+  var s4next = document.getElementById("step-4-next");
+  if (s4next) s4next.addEventListener("click", function() { showStep(nextStep(4)); });
+
+  // Step 5: finish
+  var s5finish = document.getElementById("step-5-finish");
+  if (s5finish) s5finish.addEventListener("click", completeOnboarding);
 
   // Back buttons
   document.querySelectorAll(".onboarding-btn-back").forEach(function(btn) {
@@ -616,13 +691,13 @@ document.addEventListener("DOMContentLoaded", async function() {
   try {
     var migration = await apiFetch("/api/migration/password-status");
     if (migration && migration.pending) {
-      updateCompleteChecklist();
+      updateStep5Checklist();
       showMigrationStep(migration.password || "");
       return;
     }
   } catch (_) {}
 
-  updateCompleteChecklist();
+  updateStep5Checklist();
   showStep(1);
   loadStep1();
 });

app/sovran_systemsos_web/templates/index.html

@@ -21,17 +21,9 @@
   <!-- Header bar -->
   <header class="header-bar">
     <img src="/static/sovran-hub-icon.svg" alt="Sovran Hub" class="header-logo" />
-
-    <div class="title-group">
-      <span class="title">Sovran_SystemsOS Hub</span>
-
-      <!-- OS Version Badge — styled identically to the version badge in service modals -->
-      <span class="os-version-badge" id="os-version-badge" title="Sovran_SystemsOS Version">v{{ sovran_version }}</span>
-    </div>
-
+    <span class="title">Sovran_SystemsOS Hub</span>
     <div class="header-buttons">
       <span class="role-badge" id="role-badge">Loading…</span>
-      <button class="btn btn-header-reboot" id="btn-header-reboot" title="Restart the entire computer">Reboot</button>
       <button class="btn btn-logout" id="btn-logout" title="Sign out">Sign Out</button>
     </div>
   </header>
@@ -69,7 +61,7 @@
       <div class="modal-log" id="modal-log" aria-live="polite"></div>
       <div class="modal-footer">
         <button class="btn btn-save" id="btn-save-report" style="display:none">Save Error Report</button>
-        <button class="btn btn-reboot" id="btn-reboot" style="display:none">Restart Entire System</button>
+        <button class="btn btn-reboot" id="btn-reboot" style="display:none">Reboot</button>
         <button class="btn btn-close-modal" id="btn-close-modal" disabled>Close</button>
       </div>
     </div>
@@ -172,7 +164,7 @@
       <div class="modal-log" id="rebuild-log" aria-live="polite"></div>
       <div class="modal-footer">
         <button class="btn btn-save" id="rebuild-save-report" style="display:none">Save Error Report</button>
-        <button class="btn btn-reboot" id="rebuild-reboot-btn" style="display:none">Restart Entire System</button>
+        <button class="btn btn-reboot" id="rebuild-reboot-btn" style="display:none">Reboot</button>
         <button class="btn btn-close-modal" id="rebuild-close-btn" disabled>Close</button>
       </div>
     </div>
@@ -248,68 +240,32 @@
         You will need it to log in to your computer<br />and the Sovran Hub at <em>sovransystemsos.local</em>.
       </p>
       <button class="security-reset-reboot-btn" id="security-reset-reboot-btn" disabled>
-        I have written down my new password — Restart Entire System
+        I have written down my new password — Reboot now
       </button>
     </div>
   </div>
 
   <!-- Reboot overlay -->
   <div class="reboot-overlay" id="reboot-overlay">
-    <!-- Normal restarting card -->
-    <div class="reboot-card" id="reboot-main-card">
-      <div class="reboot-icon" aria-hidden="true">↻</div>
-      <h2 class="reboot-title">Restarting Entire System</h2>
+    <div class="reboot-card">
+      <div class="reboot-icon">↻</div>
+      <h2 class="reboot-title">System Rebooting</h2>
       <p class="reboot-message">
-        The entire computer is restarting, including the desktop and all hosted services.<br />
-        This page will reconnect automatically when Sovran_SystemsOS is back online.
+        Sovran_SystemsOS is now restarting.<br />
+        This page will automatically reconnect once the system is back online.
       </p>
-      <div class="reboot-dots" aria-hidden="true">
+      <div class="reboot-dots">
         <span class="reboot-dot"></span>
         <span class="reboot-dot"></span>
         <span class="reboot-dot"></span>
       </div>
-      <p class="reboot-submessage" id="reboot-submessage" aria-live="polite">Sending restart request…</p>
-    </div>
-    <!-- Error card (shown if restart request fails definitively) -->
-    <div class="reboot-card" id="reboot-error-card" style="display:none">
-      <div class="reboot-icon" aria-hidden="true">⚠</div>
-      <h2 class="reboot-title">Restart could not be started</h2>
-      <p class="reboot-message">
-        The computer did not begin restarting. No services were intentionally stopped. Please try again.
-      </p>
-      <div class="reboot-error-actions">
-        <button class="btn btn-close-modal" id="reboot-error-close-btn">Close</button>
-        <button class="btn btn-restart-amber" id="reboot-error-retry-btn">Try Again</button>
-      </div>
-    </div>
-  </div>
-
-  <!-- Restart Confirm Dialog -->
-  <div class="modal-overlay" id="restart-confirm-modal" role="dialog" aria-modal="true" aria-labelledby="restart-confirm-title">
-    <div class="creds-dialog domain-narrow-dialog">
-      <div class="creds-header">
-        <span class="creds-title" id="restart-confirm-title">Restart the entire computer?</span>
-      </div>
-      <div class="creds-body">
-        <div id="restart-conflict-box" class="restart-conflict-box" style="display:none">
-          <p class="restart-conflict-title">The system cannot restart right now.</p>
-          <p class="restart-conflict-desc">A system update, rebuild, backup, restore, or security operation is currently running. Wait for it to finish, then try again.</p>
-        </div>
-        <p class="support-desc"><strong>This will reboot the physical machine running Sovran_SystemsOS — not just the Hub.</strong></p>
-        <p class="support-desc">The desktop and all hosted services will stop temporarily and restart with the computer. Anyone currently using these services will be disconnected.</p>
-        <p class="support-desc">The system usually returns within 1–3 minutes. This page will reconnect automatically.</p>
-        <div class="domain-field-actions">
-          <button class="btn btn-close-modal" id="restart-confirm-cancel-btn">Cancel</button>
-          <button class="btn btn-restart-amber" id="restart-confirm-ok-btn">Restart Entire System</button>
-        </div>
-      </div>
+      <p class="reboot-submessage">Stay tuned…</p>
     </div>
   </div>
 
   <script src="/static/js/constants.js?v={{ asset_version }}"></script>
   <script src="/static/js/state.js?v={{ asset_version }}"></script>
   <script src="/static/js/helpers.js?v={{ asset_version }}"></script>
-  <script src="/static/js/domain-prereqs.js?v={{ asset_version }}"></script>
   <script src="/static/js/tiles.js?v={{ asset_version }}"></script>
   <script src="/static/js/service-detail.js?v={{ asset_version }}"></script>
   <script src="/static/js/support.js?v={{ asset_version }}"></script>

app/sovran_systemsos_web/templates/onboarding.html

@@ -34,6 +34,8 @@
       <span class="onboarding-step-dot" data-step="3">3</span>
       <span class="onboarding-step-connector"></span>
       <span class="onboarding-step-dot" data-step="4">4</span>
+      <span class="onboarding-step-connector"></span>
+      <span class="onboarding-step-dot" data-step="5">5</span>
     </div>
 
     <!-- Step panels -->
@@ -125,8 +127,10 @@
           <span class="onboarding-step-icon">🌐</span>
           <h2 class="onboarding-step-title">Domain Configuration</h2>
           <p class="onboarding-step-desc">
-            Sovran_SystemsOS uses <strong><a href="https://njal.la" target="_blank" style="color: var(--accent-color);">Njal.la</a></strong> for domains and Dynamic DNS, and your router needs ports <strong>80</strong> and <strong>443</strong> (TCP) forwarded to this computer.
-            Everything you need — Njal.la account, Dynamic records, and the one router task — is laid out step by step below.
+            Sovran_SystemsOS uses <strong><a href="https://njal.la" target="_blank" style="color: var(--accent-color);">Njal.la</a></strong> for domains and Dynamic DNS.
+            First, create an account at <strong>Njal.la</strong> and purchase a new domain, or create a subdomain from a domain you already own. Tip: Subdomains are free to create — you only need to purchase one domain, and you can add as many subdomains as you need at no extra cost.
+            Then, in the Njal.la web interface, create a <strong>Dynamic</strong> record pointing to this machine's external IP address (shown below).
+            Finally, paste the DDNS curl command from your Njal.la dashboard for each service below.
           </p>
         </div>
         <div class="onboarding-card" id="step-3-body">
@@ -141,8 +145,29 @@
         </div>
       </div>
 
-      <!-- ── Step 4: Complete ── -->
+      <!-- ── Step 4: Port Forwarding ── -->
       <div class="onboarding-panel" id="step-4" style="display:none">
+        <div class="onboarding-step-header">
+          <span class="onboarding-step-icon">🔌</span>
+          <h2 class="onboarding-step-title">Port Forwarding Check</h2>
+          <p class="onboarding-step-desc">
+            Forward these ports on your router to this machine. Each port only needs to be opened once — they are shared across all your services.
+            <strong>Ports 80 and 443 must be open for SSL certificates to work.</strong>
+          </p>
+        </div>
+        <div class="onboarding-card" id="step-4-body">
+          <p class="onboarding-loading">Checking ports…</p>
+        </div>
+        <div class="onboarding-footer">
+          <button class="btn btn-close-modal onboarding-btn-back" data-prev="3">← Back</button>
+          <button class="btn btn-primary onboarding-btn-next" id="step-4-next">
+            Continue →
+          </button>
+        </div>
+      </div>
+
+      <!-- ── Step 5: Complete ── -->
+      <div class="onboarding-panel" id="step-5" style="display:none">
         <div class="onboarding-hero">
           <div class="onboarding-logo">✅</div>
           <h1 class="onboarding-title">Your Sovran_SystemsOS is Ready!</h1>
@@ -156,11 +181,12 @@
           <ul class="onboarding-checklist" id="onboarding-checklist">
             <li>✅ Timezone &amp; locale configured</li>
             <li>✅ Domain configuration saved</li>
+            <li>✅ Port forwarding reviewed</li>
           </ul>
         </div>
         <div class="onboarding-footer">
-          <button class="btn btn-close-modal onboarding-btn-back" data-prev="3">← Back</button>
-          <button class="btn btn-primary" id="step-4-finish">
+          <button class="btn btn-close-modal onboarding-btn-back" data-prev="4">← Back</button>
+          <button class="btn btn-primary" id="step-5-finish">
             Go to Dashboard →
           </button>
         </div>
@@ -169,7 +195,6 @@
     </div><!-- /panel-wrap -->
   </div><!-- /shell -->
 
-  <script src="/static/js/domain-prereqs.js?v={{ asset_version }}"></script>
   <script src="/static/onboarding.js?v={{ onboarding_js_hash }}"></script>
 </body>
 </html>

app/sovran_systemsos_web/versions.json

@@ -1,16 +0,0 @@
-{
-  "caddy.service": "2.8.4",
-  "tor.service": "0.4.8.12",
-  "gnome-remote-desktop.service": "46.0",
-  "bitcoind.service": "27.1.0",
-  "electrs.service": "0.10.6",
-  "lnd.service": "0.18.0",
-  "rtl.service": "0.15.2",
-  "btcpayserver.service": "2.0.0",
-  "albyhub.service": "1.8.0",
-  "mempool.service": "3.0.0",
-  "matrix-synapse.service": "1.115.0",
-  "livekit.service": "1.5.2",
-  "vaultwarden.service": "1.32.0",
-  "haven-relay.service": "0.1.0"
-}

app/tests/test_bip110_status.py

@@ -0,0 +1,166 @@
+import unittest
+from unittest.mock import patch
+from pathlib import Path
+import sys
+import types
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+
+
+def _install_web_stubs():
+    if "fastapi" in sys.modules:
+        return
+
+    class _HTTPException(Exception):
+        def __init__(self, status_code=None, detail=None):
+            super().__init__(detail)
+            self.status_code = status_code
+            self.detail = detail
+
+    class _FastAPI:
+        def __init__(self, *args, **kwargs):
+            pass
+
+        def mount(self, *args, **kwargs):
+            return None
+
+        def add_middleware(self, *args, **kwargs):
+            return None
+
+        def __getattr__(self, _name):
+            def _decorator_factory(*args, **kwargs):
+                def _decorator(func):
+                    return func
+
+                return _decorator
+
+            return _decorator_factory
+
+    class _BaseModel:
+        pass
+
+    class _StaticFiles:
+        def __init__(self, *args, **kwargs):
+            pass
+
+    class _Jinja2Templates:
+        def __init__(self, *args, **kwargs):
+            pass
+
+    class _BaseHTTPMiddleware:
+        pass
+
+    fastapi_module = types.ModuleType("fastapi")
+    fastapi_module.FastAPI = _FastAPI
+    fastapi_module.HTTPException = _HTTPException
+    sys.modules["fastapi"] = fastapi_module
+
+    responses_module = types.ModuleType("fastapi.responses")
+    responses_module.HTMLResponse = object
+    responses_module.JSONResponse = object
+    responses_module.RedirectResponse = object
+    sys.modules["fastapi.responses"] = responses_module
+
+    staticfiles_module = types.ModuleType("fastapi.staticfiles")
+    staticfiles_module.StaticFiles = _StaticFiles
+    sys.modules["fastapi.staticfiles"] = staticfiles_module
+
+    templating_module = types.ModuleType("fastapi.templating")
+    templating_module.Jinja2Templates = _Jinja2Templates
+    sys.modules["fastapi.templating"] = templating_module
+
+    requests_module = types.ModuleType("fastapi.requests")
+    requests_module.Request = object
+    sys.modules["fastapi.requests"] = requests_module
+
+    pydantic_module = types.ModuleType("pydantic")
+    pydantic_module.BaseModel = _BaseModel
+    sys.modules["pydantic"] = pydantic_module
+
+    starlette_base_module = types.ModuleType("starlette.middleware.base")
+    starlette_base_module.BaseHTTPMiddleware = _BaseHTTPMiddleware
+    sys.modules["starlette.middleware.base"] = starlette_base_module
+
+    starlette_middleware_module = types.ModuleType("starlette.middleware")
+    starlette_middleware_module.base = starlette_base_module
+    sys.modules["starlette.middleware"] = starlette_middleware_module
+
+    starlette_module = types.ModuleType("starlette")
+    starlette_module.middleware = starlette_middleware_module
+    sys.modules["starlette"] = starlette_module
+
+
+_install_web_stubs()
+from sovran_systemsos_web import server
+
+
+class Bip110StatusTests(unittest.TestCase):
+    def _status(self, deploy_info, net_info):
+        with patch.object(server, "_get_bitcoin_deployment_info", return_value=deploy_info), patch.object(
+            server, "_get_bitcoin_version_info", return_value=net_info
+        ):
+            return server._get_bip110_status()
+
+    def test_started_reduced_data_reports_signaling(self):
+        deploy_info = {
+            "deployments": {
+                "reduced_data": {
+                    "type": "bip9",
+                    "active": False,
+                    "bip9": {
+                        "bit": 4,
+                        "status": "started",
+                        "statistics": {"elapsed": 833, "count": 4, "threshold": 1109},
+                        "signalling": "--#--",
+                    },
+                }
+            }
+        }
+
+        result = self._status(deploy_info, {"subversion": "/Satoshi:29.0.0/"})
+        self.assertEqual(
+            result,
+            {"supported": True, "signaling": True, "state": "signaling", "source": "getdeploymentinfo"},
+        )
+
+    def test_active_reduced_data_reports_active(self):
+        deploy_info = {
+            "deployments": {"reduced_data": {"active": True, "bip9": {"bit": 4, "status": "active"}}}
+        }
+
+        result = self._status(deploy_info, {"subversion": "/Satoshi:29.0.0/"})
+        self.assertEqual(result["state"], "active")
+        self.assertTrue(result["supported"])
+        self.assertTrue(result["signaling"])
+        self.assertEqual(result["source"], "getdeploymentinfo")
+
+    def test_locked_in_reduced_data_reports_locked_in(self):
+        deploy_info = {
+            "deployments": {"reduced_data": {"active": False, "bip9": {"bit": 4, "status": "locked_in"}}}
+        }
+
+        result = self._status(deploy_info, {"subversion": "/Satoshi:29.0.0/"})
+        self.assertEqual(result["state"], "locked_in")
+        self.assertTrue(result["supported"])
+        self.assertTrue(result["signaling"])
+        self.assertEqual(result["source"], "getdeploymentinfo")
+
+    def test_no_bip110_deployment_and_plain_subversion_reports_unsupported(self):
+        deploy_info = {
+            "deployments": {
+                "taproot": {"type": "bip9", "active": True, "bip9": {"bit": 2, "status": "active"}},
+            }
+        }
+        result = self._status(deploy_info, {"subversion": "/Satoshi:27.0.0/"})
+        self.assertEqual(
+            result,
+            {"supported": False, "signaling": False, "state": "unsupported", "source": "subversion"},
+        )
+
+    def test_node_unreachable_reports_unknown(self):
+        result = self._status(None, None)
+        self.assertEqual(result, {"supported": False, "signaling": False, "state": "unknown", "source": "none"})
+
+
+if __name__ == "__main__":
+    unittest.main()

configuration.nix

@@ -149,8 +149,8 @@
     gparted pv unzip parted screen zenity
     libargon2 gnome-terminal libreoffice-fresh
     dig firefox wp-cli axel
-    lk-jwt-service livekit-libwebrtc livekit
-    matrix-synapse age onlyoffice-desktopeditors
+    lk-jwt-service livekit-libwebrtc livekit-cli livekit
+    matrix-synapse age
   ];
 
   # ── Shell ──────────────────────────────────────────────────

flake.lock

@@ -5,11 +5,11 @@
         "nixpkgs": "nixpkgs"
       },
       "locked": {
-        "lastModified": 1785778881,
-        "narHash": "sha256-yHJJTm3o7ZhiVp68G+hh+dz1GKV+ACOT6mQj+eYvJLQ=",
+        "lastModified": 1781013869,
+        "narHash": "sha256-XlEUtL+8M6kbPdmIh4sQQ7G02/1CwHQEk1RPvIMEWOs=",
         "owner": "emmanuelrosa",
         "repo": "btc-clients-nix",
-        "rev": "fc1aca94d839f82e7501fe0d01279d5c1fba6e63",
+        "rev": "9a6c78204dc8961840375b110bca595b1f6f084c",
         "type": "github"
       },
       "original": {
@@ -52,11 +52,11 @@
         ]
       },
       "locked": {
-        "lastModified": 1782949081,
-        "narHash": "sha256-vp6Y/Grm98ESt6ceOkWiHWyZRDV3J1RID4w+6NWK9yA=",
+        "lastModified": 1778716662,
+        "narHash": "sha256-m1Yf0wZ8j1OHjTc2UwHwyQRSnNeSgLJOd7q5Y45hzi4=",
         "owner": "hercules-ci",
         "repo": "flake-parts",
-        "rev": "17c9d6cdfc60c64f4ee8d306f9bc0b4ccb51481e",
+        "rev": "f7c1a2d347e4c52d5fb8d10cb4d94b5884e546fb",
         "type": "github"
       },
       "original": {
@@ -92,11 +92,11 @@
         "nixpkgs-unstable": "nixpkgs-unstable"
       },
       "locked": {
-        "lastModified": 1785177868,
-        "narHash": "sha256-zlAZZkokXpeHHBP8Nt4MvLXOn1Js1qVi81VPjtVbRV8=",
+        "lastModified": 1779253922,
+        "narHash": "sha256-k5DpYVfyy27ELuEiV+51EfVg7B6vKUW63NWeA6eKGd0=",
         "owner": "fort-nix",
         "repo": "nix-bitcoin",
-        "rev": "360e30fee5ba32f9fecc89bc35628195d9d2dbbe",
+        "rev": "1496f842477976c085cd96f1837ea12444014088",
         "type": "github"
       },
       "original": {
@@ -108,11 +108,11 @@
     },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1785590095,
-        "narHash": "sha256-CNO2szJbdLjVN/Hi1BML9MSALz1GM2fIdwnzs404QO8=",
+        "lastModified": 1780218263,
+        "narHash": "sha256-T/f0pPDrH3Qc1VXyQXbK7yfHWRn90l3xwplc/nsxin4=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "e568f3b19d54b08f48bfae9b12b3e124d1a28002",
+        "rev": "7fc393d1b46fa000d48ff14e8b6a3c9985f03af0",
         "type": "github"
       },
       "original": {
@@ -139,11 +139,11 @@
     },
     "nixpkgs-stable": {
       "locked": {
-        "lastModified": 1785734586,
-        "narHash": "sha256-ODZkEK9Gy50yg6h98u7KkitZ3oc/uuTFK00bh1CRdNA=",
+        "lastModified": 1780902259,
+        "narHash": "sha256-q8yYEC5f1mFlQO9RGna4LTc9QrcvWunX6FYp83munkQ=",
         "owner": "nixos",
         "repo": "nixpkgs",
-        "rev": "531670d871c0e29724a02f3cbcac170adc65b58c",
+        "rev": "bd0ff2d3eac24699c3664d5966b9ef36f388e2ca",
         "type": "github"
       },
       "original": {
@@ -155,11 +155,11 @@
     },
     "nixpkgs-unstable": {
       "locked": {
-        "lastModified": 1784453100,
-        "narHash": "sha256-zpGZb8FYui+i8KLtC0nlcmb0voR2zB80Qn8pe7lzIbk=",
+        "lastModified": 1778869304,
+        "narHash": "sha256-30sZNZoA1cqF5JNO9fVX+wgiQYjB7HJqqJ4ztCDeBZE=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "b471514bed69eff5255c8e63c1f80e5fe56c616f",
+        "rev": "d233902339c02a9c334e7e593de68855ad26c4cb",
         "type": "github"
       },
       "original": {
@@ -171,11 +171,11 @@
     },
     "nixpkgs_2": {
       "locked": {
-        "lastModified": 1782847189,
-        "narHash": "sha256-twXPFqFsrrY5r28Zh7Homgcp2gUMBgQ6WDS98Q/3xFI=",
+        "lastModified": 1778737229,
+        "narHash": "sha256-6xWoytx8jFW4PF1GjRm/i/53trbpKGfz6zjzQGBr4cI=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "b6018f87da91d19d0ab4cf979885689b469cdd41",
+        "rev": "d7a713c0b7e47c908258e71cba7a2d77cc8d71d5",
         "type": "github"
       },
       "original": {
@@ -187,11 +187,11 @@
     },
     "nixpkgs_3": {
       "locked": {
-        "lastModified": 1785828668,
-        "narHash": "sha256-8fsyqeO+mJqvIzeO4xIpgJe/f7MTbbVTEC6RT6WSXNs=",
+        "lastModified": 1780749050,
+        "narHash": "sha256-3av0pIjlOWQ6rDbNOmpUSvbNnJkGORQKKjb4LtCZsIY=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "e72e4f299401a3689d4b3d5fc6496b11db7064eb",
+        "rev": "a799d3e3886da994fa307f817a6bc705ae538eeb",
         "type": "github"
       },
       "original": {
@@ -203,11 +203,11 @@
     },
     "nixpkgs_4": {
       "locked": {
-        "lastModified": 1784555310,
-        "narHash": "sha256-/FCliTPgiuV1owejZFNx3Ch9irdvkOfOFl+HHZ+DrtM=",
+        "lastModified": 1780336545,
+        "narHash": "sha256-vhVhuXzFrIOfcssC/9hDHx7MHzDKjF3keHuREOQqQiQ=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "421eebfd0ec7bccd4abe826ce62d7e6e83129493",
+        "rev": "4df1b885d76a54e1aa1a318f8d16fd6005b6401f",
         "type": "github"
       },
       "original": {
@@ -224,11 +224,11 @@
         "systems": "systems_2"
       },
       "locked": {
-        "lastModified": 1785763201,
-        "narHash": "sha256-wA373y/B9orM3HatLu9oS+Ke5lmdZyBl/bdjd2gLMq4=",
+        "lastModified": 1780995253,
+        "narHash": "sha256-6Lsoyw2XPvY8YNMCtPnsyw0JVVtHsXP2xtrFJBBTAOQ=",
         "owner": "nix-community",
         "repo": "nixvim",
-        "rev": "c7be49306b23a952c0151cf4bbeacd944ed82f2a",
+        "rev": "43a7e6f82978ac975c3bba6728869b231e7a1ba0",
         "type": "github"
       },
       "original": {

flake.nix

@@ -57,14 +57,5 @@
 				];
 			};
 		};
-
-		nixosTests.nwc-wallets-port-collision =
-			import ./nix/tests/nwc-wallets-port-collision.nix {
-				inherit nixpkgs;
-				system = "x86_64-linux";
-			};
-
-		checks.x86_64-linux.nwc-wallets-port-collision =
-			self.nixosTests.nwc-wallets-port-collision;
 	};
 }

iso/common.nix

@@ -3,14 +3,6 @@
 let
   sovranSource = builtins.path { path = ../.; name = "sovran-systemsos"; };
 
-  # Read version from VERSION file if it exists, otherwise fall back to "dev"
-  versionFile = if builtins.pathExists ../VERSION
-                then builtins.readFile ../VERSION
-                else "dev";
-
-  # Clean version (remove 'v' prefix and newlines)
-  cleanVersion = builtins.replaceStrings ["v" "\n" "\r"] ["" "" ""] versionFile;
-
   pythonEnv = pkgs.python3.withPackages (ps: [ ps.pygobject3 ps.pycairo ]);
 
   installerPy = pkgs.writeShellScriptBin "sovran-install" ''
@@ -26,8 +18,7 @@ in
     "${modulesPath}/installer/cd-dvd/installation-cd-graphical-gnome.nix"
   ];
 
-  # Dynamic ISO filename with version
-  image.baseName = lib.mkForce "Sovran_SystemsOS-${cleanVersion}";
+  image.baseName = lib.mkForce "Sovran_SystemsOS";
   isoImage.splashImage = ./assets/splash-logo.png;
 
   services.gnome.gnome-initial-setup.enable = false;

iso/installer.py

@@ -103,81 +103,25 @@ def human_size(nbytes):
     return f"{nbytes:.1f} PB"
 
 def check_internet():
-    """Return True if the machine can reach the internet.
-
-    Some VM NAT setups and managed networks block ICMP even when HTTPS works,
-    so keep the existing ping checks but fall back to small HTTPS requests.
-    """
-    checks = [
-        ["ping", "-c", "1", "-W", "5", "nixos.org"],
-        ["curl", "--location", "--fail", "--silent", "--show-error", "--connect-timeout", "5", "--max-time", "10", "--output", "/dev/null", "https://cache.nixos.org/nix-cache-info"],
-        ["curl", "--location", "--fail", "--silent", "--show-error", "--connect-timeout", "5", "--max-time", "10", "--output", "/dev/null", "https://nixos.org/"],
-        ["ping", "-c", "1", "-W", "5", "1.1.1.1"],
-    ]
-
-    for cmd in checks:
-        try:
-            result = subprocess.run(cmd, capture_output=True, text=True)
-            if result.returncode == 0:
-                return True
-            log(f"Connectivity check failed ({' '.join(cmd)}): {result.stderr.strip() or result.stdout.strip()}")
-        except Exception as e:
-            log(f"Connectivity check failed ({' '.join(cmd)}): {e}")
-
-    return False
-
-def detect_virtualization():
-    """Return the VM technology name when running inside a VM, else None."""
+    """Return True if the machine can reach the internet."""
     try:
         result = subprocess.run(
-            ["systemd-detect-virt", "--vm"],
+            ["ping", "-c", "1", "-W", "5", "nixos.org"],
             capture_output=True, text=True
         )
         if result.returncode == 0:
-            name = result.stdout.strip()
-            if name == "none":
-                return None
-            return name or "virtual machine"
+            return True
     except Exception:
         pass
-
-    # Fallback for minimal environments where systemd-detect-virt is absent.
-    dmi_paths = [
-        "/sys/class/dmi/id/product_name",
-        "/sys/class/dmi/id/sys_vendor",
-        "/sys/class/dmi/id/board_vendor",
-    ]
-    markers = (
-        "kvm", "qemu", "virtualbox", "vmware", "hyper-v",
-        "bhyve", "parallels", "xen", "bochs", "virtual",
-    )
-    for dmi_path in dmi_paths:
-        try:
-            value = open(dmi_path, "r", encoding="utf-8", errors="ignore").read().strip()
-        except OSError:
-            continue
-        lowered = value.lower()
-        if any(marker in lowered for marker in markers):
-            return value or "virtual machine"
-
-    return None
-
-def detect_boot_mode():
-    """Return the firmware mode used to boot the installer ISO."""
-    return "uefi" if os.path.isdir("/sys/firmware/efi") else "bios"
-
-def boot_mode_label(mode):
-    if mode == "uefi":
-        return "UEFI (systemd-boot)"
-    return "Legacy BIOS (GRUB)"
-
-def nix_string(value):
-    """Quote a Python string for a simple Nix string literal."""
-    escaped = value.replace("\\", "\\\\")
-    escaped = escaped.replace('"', '\\"')
-    escaped = escaped.replace("\n", "\\n").replace("\r", "\\r").replace("\t", "\\t")
-    escaped = escaped.replace("${", "\\${")
-    return f'"{escaped}"'
+    # Fallback: try a second host in case DNS for nixos.org is down
+    try:
+        result = subprocess.run(
+            ["ping", "-c", "1", "-W", "5", "1.1.1.1"],
+            capture_output=True, text=True
+        )
+        return result.returncode == 0
+    except Exception:
+        return False
 
 def symbolic_icon(name):
     """Create a crisp symbolic icon suitable for use as an ActionRow prefix."""
@@ -215,10 +159,6 @@ class InstallerWindow(Adw.ApplicationWindow):
         self.data_size = None
         self.data_drive_has_timechain = False
         self.free_password = None
-        self.virtualization = detect_virtualization()
-        self.boot_mode = detect_boot_mode()
-
-        log(f"Installer environment: boot_mode={self.boot_mode}, virtualization={self.virtualization or 'none'}")
 
         # Root navigation view
         self.nav = Adw.NavigationView()
@@ -403,7 +343,7 @@ class InstallerWindow(Adw.ApplicationWindow):
         if os.path.exists(LOGO):
             try:
                 img = Gtk.Image.new_from_file(LOGO)
-                img.set_pixel_size(320 if self.virtualization else 480)
+                img.set_pixel_size(480)
                 hero.append(img)
             except Exception:
                 pass
@@ -457,42 +397,6 @@ class InstallerWindow(Adw.ApplicationWindow):
         notice_frame.set_child(notice_box)
         outer.append(notice_frame)
 
-        if self.virtualization:
-            vm_frame = Gtk.Frame()
-            vm_frame.add_css_class("card")
-            vm_frame.set_margin_start(40)
-            vm_frame.set_margin_end(40)
-            vm_frame.set_margin_top(12)
-            vm_frame.set_margin_bottom(4)
-
-            vm_box = Gtk.Box(orientation=Gtk.Orientation.HORIZONTAL, spacing=12)
-            vm_box.set_margin_top(12)
-            vm_box.set_margin_bottom(12)
-            vm_box.set_margin_start(16)
-            vm_box.set_margin_end(16)
-
-            vm_icon = symbolic_icon("computer-symbolic")
-            vm_icon.set_valign(Gtk.Align.START)
-            vm_box.append(vm_icon)
-
-            vm_lbl = Gtk.Label()
-            vm_lbl.set_use_markup(True)
-            vm_lbl.set_wrap(True)
-            vm_lbl.set_xalign(0)
-            vm_lbl.set_halign(Gtk.Align.FILL)
-            vm_lbl.set_markup(
-                f"<span weight='bold'>Virtual machine detected: {GLib.markup_escape_text(self.virtualization)}</span>\n"
-                f"Boot mode: <span weight='bold'>{boot_mode_label(self.boot_mode)}</span>. "
-                "For the smoothest VM test, use 8+ GB RAM, NAT/bridged networking, "
-                "and a thin-provisioned virtual OS disk of at least 256 GB. "
-                "For Node or Server + Desktop, attach a second 2 TB virtual data disk; "
-                "otherwise choose Desktop Only."
-            )
-            vm_box.append(vm_lbl)
-
-            vm_frame.set_child(vm_box)
-            outer.append(vm_frame)
-
         # Role label
         role_lbl = Gtk.Label()
         role_lbl.set_markup("<span size='medium' weight='bold'>Choose your installation type:</span>")
@@ -544,10 +448,7 @@ class InstallerWindow(Adw.ApplicationWindow):
 
             available = has_second_drive or key not in NEEDS_DATA_DRIVE
             if not available:
-                drive_hint = "⚠ Requires a second internal drive (not detected)"
-                if self.virtualization:
-                    drive_hint += " — in a VM, attach a second virtual disk or choose Desktop Only"
-                card.set_subtitle(desc + f"\n{drive_hint}")
+                card.set_subtitle(desc + "\n⚠ Requires a second internal drive (not detected)")
                 card.set_sensitive(False)
             else:
                 card.set_subtitle(desc)
@@ -630,10 +531,9 @@ class InstallerWindow(Adw.ApplicationWindow):
         # ── OS Drive group ────────────────────────────────────────────
         os_group = Adw.PreferencesGroup()
         os_group.set_title("OS Drive  (NixOS Boot + Root)")
-        os_description = "Choose the drive for the NixOS installation.  Minimum 256 GB required."
-        if self.virtualization:
-            os_description += " In a VM, a thin-provisioned virtual disk is OK."
-        os_group.set_description(os_description)
+        os_group.set_description(
+            "Choose the drive for the NixOS installation.  Minimum 256 GB required."
+        )
         os_group.set_margin_top(24)
         os_group.set_margin_start(40)
         os_group.set_margin_end(40)
@@ -646,8 +546,6 @@ class InstallerWindow(Adw.ApplicationWindow):
             row.set_title(f"/dev/{name}")
             type_label = tran.upper() if tran else "Disk"
             meets = "✓ Meets 256 GB minimum" if size >= BYTES_256GB else "✗ Below 256 GB minimum"
-            if self.virtualization and size < BYTES_256GB:
-                meets += " (expand the virtual disk)"
             row.set_subtitle(f"{human_size(size)}  ·  {type_label}  —  {meets}")
             row.add_prefix(symbolic_icon("drive-harddisk-symbolic"))
 
@@ -672,14 +570,11 @@ class InstallerWindow(Adw.ApplicationWindow):
         if self.role != "Desktop Only":
             data_group = Adw.PreferencesGroup()
             data_group.set_title("Bitcoin Timechain & Backups Drive")
-            data_description = (
+            data_group.set_description(
                 "💡 Tip: Always assign your LARGEST drive here.  "
                 "The full Bitcoin timechain is over 700 GB and grows continuously — "
                 "a 2 TB or larger drive is required."
             )
-            if self.virtualization:
-                data_description += " In a VM, attach a second 2 TB thin-provisioned virtual disk for Node or Server + Desktop."
-            data_group.set_description(data_description)
             data_group.set_margin_top(20)
             data_group.set_margin_start(40)
             data_group.set_margin_end(40)
@@ -704,8 +599,6 @@ class InstallerWindow(Adw.ApplicationWindow):
                 row.set_title(f"/dev/{name}")
                 type_label = tran.upper() if tran else "Disk"
                 meets = "✓ Meets 2 TB minimum" if size >= BYTES_2TB else "✗ Below 2 TB minimum"
-                if self.virtualization and size < BYTES_2TB:
-                    meets += " (use a 2 TB thin-provisioned virtual disk)"
                 row.set_subtitle(f"{human_size(size)}  ·  {type_label}  —  {meets}")
                 row.add_prefix(symbolic_icon("drive-harddisk-symbolic"))
 
@@ -762,16 +655,10 @@ class InstallerWindow(Adw.ApplicationWindow):
             dlg = Adw.MessageDialog()
             dlg.set_transient_for(self)
             dlg.set_heading("OS Drive Too Small")
-            body = (
+            dlg.set_body(
                 f"The selected OS drive (/dev/{os_name}, {human_size(os_size)}) "
                 f"does not meet the 256 GB minimum.  Please choose a larger drive."
             )
-            if self.virtualization:
-                body += (
-                    "\n\nVM tip: expand the virtual OS disk to at least 256 GB. "
-                    "Thin-provisioned disks usually do not consume the full size immediately."
-                )
-            dlg.set_body(body)
             dlg.add_response("ok", "OK")
             dlg.present()
             return
@@ -781,18 +668,12 @@ class InstallerWindow(Adw.ApplicationWindow):
             dlg = Adw.MessageDialog()
             dlg.set_transient_for(self)
             dlg.set_heading("Bitcoin Drive Too Small")
-            body = (
+            dlg.set_body(
                 f"The selected Bitcoin Timechain & Backups drive "
                 f"(/dev/{data_name}, {human_size(data_size)}) "
                 f"does not meet the 2 TB minimum.  "
                 f"Please choose a larger drive or select \"None\"."
             )
-            if self.virtualization:
-                body += (
-                    "\n\nVM tip: attach a second 2 TB thin-provisioned virtual disk "
-                    "for Node or Server + Desktop test installs."
-                )
-            dlg.set_body(body)
             dlg.add_response("ok", "OK")
             dlg.present()
             return
@@ -948,12 +829,7 @@ class InstallerWindow(Adw.ApplicationWindow):
     # ── Worker: partition ─────────────────────────────────────────────────
 
     def partition_path(self, dev_path, num):
-        base = os.path.basename(dev_path)
-        needs_p = (
-            base.startswith(("nvme", "mmcblk", "loop", "md")) or
-            (base[-1:].isdigit())
-        )
-        return f"{dev_path}p{num}" if needs_p else f"{dev_path}{num}"
+        return f"{dev_path}p{num}" if "nvme" in dev_path else f"{dev_path}{num}"
 
     def detect_existing_timechain_data(self, data_path, buf=None):
         data_p1 = self.partition_path(data_path, 1)
@@ -1024,19 +900,12 @@ class InstallerWindow(Adw.ApplicationWindow):
 
         time.sleep(2)
 
-        # ── Partition boot disk ──
-        if self.boot_mode == "uefi":
-            GLib.idle_add(append_text, buf, "\n=== Partitioning boot disk (UEFI) ===\n")
-            run_stream(["sudo", "sgdisk",
-                        "-n", "1:1M:+512M", "-t", "1:EF00", "-c", "1:ESP",
-                        "-n", "2:0:0",      "-t", "2:8300", "-c", "2:root",
-                        boot_path], buf)
-        else:
-            GLib.idle_add(append_text, buf, "\n=== Partitioning boot disk (Legacy BIOS) ===\n")
-            run_stream(["sudo", "sgdisk",
-                        "-n", "1:1M:+1M", "-t", "1:EF02", "-c", "1:BIOS-boot",
-                        "-n", "2:0:0",    "-t", "2:8300", "-c", "2:root",
-                        boot_path], buf)
+        # ── Partition boot disk: 512M ESP + rest as root ──
+        GLib.idle_add(append_text, buf, "\n=== Partitioning boot disk ===\n")
+        run_stream(["sudo", "sgdisk",
+                    "-n", "1:1M:+512M", "-t", "1:EF00", "-c", "1:ESP",
+                    "-n", "2:0:0",      "-t", "2:8300", "-c", "2:root",
+                    boot_path], buf)
 
         run_stream(["sudo", "partprobe", boot_path], buf)
         time.sleep(2)
@@ -1056,10 +925,7 @@ class InstallerWindow(Adw.ApplicationWindow):
         boot_p1 = self.partition_path(boot_path, 1)
         boot_p2 = self.partition_path(boot_path, 2)
 
-        if self.boot_mode == "uefi":
-            run_stream(["sudo", "mkfs.vfat", "-F", "32", boot_p1], buf)
-        else:
-            GLib.idle_add(append_text, buf, "Skipping ESP format for Legacy BIOS install.\n")
+        run_stream(["sudo", "mkfs.vfat", "-F", "32", boot_p1], buf)
         run_stream(["sudo", "mkfs.ext4", "-F", "-L", "sovran_systemsos", boot_p2], buf)
 
         if data_path and not self.data_drive_has_timechain:
@@ -1069,11 +935,8 @@ class InstallerWindow(Adw.ApplicationWindow):
         # ── Mount filesystems ──
         GLib.idle_add(append_text, buf, "\n=== Mounting filesystems ===\n")
         run_stream(["sudo", "mount", boot_p2, "/mnt"], buf)
-        if self.boot_mode == "uefi":
-            run_stream(["sudo", "mkdir", "-p", "/mnt/boot/efi"], buf)
-            run_stream(["sudo", "mount", "-o", "umask=0077,defaults", boot_p1, "/mnt/boot/efi"], buf)
-        else:
-            GLib.idle_add(append_text, buf, "Legacy BIOS install: /boot/efi mount not required.\n")
+        run_stream(["sudo", "mkdir", "-p", "/mnt/boot/efi"], buf)
+        run_stream(["sudo", "mount", "-o", "umask=0077,defaults", boot_p1, "/mnt/boot/efi"], buf)
 
         if data_path:
             data_p1 = self.partition_path(data_path, 1)
@@ -1103,33 +966,12 @@ class InstallerWindow(Adw.ApplicationWindow):
         is_server = str(self.role == "Server+Desktop").lower()
         is_desktop = str(self.role == "Desktop Only").lower()
         is_node = str(self.role == "Node (Bitcoin-only)").lower()
-        boot_overrides = ""
-        if self.boot_mode == "bios":
-            grub_device = nix_string(f"/dev/{self.boot_disk}")
-            boot_overrides = f"""
-
-  # The installer ISO was booted in Legacy BIOS mode, so install GRUB to the
-  # target disk instead of using the default UEFI systemd-boot configuration.
-  boot.loader.systemd-boot.enable = lib.mkForce false;
-  boot.loader.efi.canTouchEfiVariables = lib.mkForce false;
-  boot.loader.grub.enable = lib.mkForce true;
-  boot.loader.grub.device = lib.mkForce {grub_device};
-  fileSystems."/boot/efi".enable = lib.mkForce false;
-"""
-        elif self.virtualization:
-            boot_overrides = """
-
-  # VM UEFI firmware can reject or forget NVRAM boot-entry writes. Keep the
-  # normal UEFI systemd-boot layout, but use the fallback removable path instead
-  # of depending on EFI variable updates.
-  boot.loader.efi.canTouchEfiVariables = lib.mkForce false;
-"""
         content = f"""# THIS FILE IS AUTO-GENERATED BY THE INSTALLER. DO NOT EDIT.
 {{ config, lib, ... }}:
 {{
   sovran_systemsOS.roles.server_plus_desktop = lib.mkDefault {is_server};
   sovran_systemsOS.roles.desktop = lib.mkDefault {is_desktop};
-  sovran_systemsOS.roles.node = lib.mkDefault {is_node};{boot_overrides}
+  sovran_systemsOS.roles.node = lib.mkDefault {is_node};
 }}
 """
         proc = subprocess.run(
@@ -1166,11 +1008,6 @@ class InstallerWindow(Adw.ApplicationWindow):
         boot_row.set_subtitle(f"/dev/{self.boot_disk}  —  {human_size(self.boot_size)}")
         details.add(boot_row)
 
-        boot_mode_row = Adw.ActionRow()
-        boot_mode_row.set_title("Boot Mode")
-        boot_mode_row.set_subtitle(boot_mode_label(self.boot_mode))
-        details.add(boot_mode_row)
-
         if self.data_disk:
             data_row = Adw.ActionRow()
             data_row.set_title("Data Disk")
@@ -1332,7 +1169,7 @@ class InstallerWindow(Adw.ApplicationWindow):
         btn_box = Gtk.Box(orientation=Gtk.Orientation.HORIZONTAL, spacing=0)
         btn_box.set_halign(Gtk.Align.CENTER)
         btn_box.set_margin_bottom(32)
-        reboot_btn = Gtk.Button(label="I Have Written Down My Password — Restart Entire System")
+        reboot_btn = Gtk.Button(label="I Have Written Down My Password — Reboot Now")
         reboot_btn.add_css_class("suggested-action")
         reboot_btn.add_css_class("pill")
         reboot_btn.connect("clicked", lambda b: subprocess.run(["sudo", "reboot"]))

iso/sovran-install-headless.sh

@@ -12,11 +12,6 @@ Options:
   --deploy-key "ssh-ed25519 AAAA..."  SSH pubkey for remote access after install
   --headscale-server URL       Headscale login server for post-install Tailnet
   --headscale-key KEY          Headscale pre-auth key for the installed OS
-
-VM notes:
-  Desktop test installs still need a 256 GB OS disk (thin-provisioned is OK).
-  Node/server installs need a separate 2 TB data disk. UEFI is preferred; UEFI
-  VMs avoid NVRAM boot-entry writes, and legacy BIOS VMs use GRUB.
 USAGE
 }
 
@@ -30,8 +25,6 @@ DEPLOY_KEY=""
 HEADSCALE_SERVER=""
 HEADSCALE_KEY=""
 DATA_DISK_HAS_TIMECHAIN=false
-BOOT_MODE=""
-VIRTUALIZATION=""
 
 FLAKE="/etc/sovran/flake"
 LOG="/tmp/sovran-headless-install.log"
@@ -76,22 +69,6 @@ case "$ROLE" in
     *) die "--role must be one of: server, desktop, node" ;;
 esac
 
-# ── Detect firmware / VM environment ─────────────────────────────────────────
-if [[ -d /sys/firmware/efi ]]; then
-    BOOT_MODE="uefi"
-else
-    BOOT_MODE="bios"
-fi
-
-if command -v systemd-detect-virt >/dev/null 2>&1; then
-    if VIRT_RESULT=$(systemd-detect-virt --vm 2>/dev/null); then
-        [[ "$VIRT_RESULT" != "none" ]] && VIRTUALIZATION="$VIRT_RESULT"
-    fi
-fi
-
-log "Boot mode: ${BOOT_MODE} ($([[ "$BOOT_MODE" == uefi ]] && echo systemd-boot || echo GRUB))"
-[[ -n "$VIRTUALIZATION" ]] && log "Virtual machine detected: ${VIRTUALIZATION}"
-
 # ── Validate disk existence and size ─────────────────────────────────────────
 log "=== Validating disks ==="
 
@@ -119,26 +96,13 @@ fi
 # ── Helper: partition suffix ──────────────────────────────────────────────────
 part_suffix() {
     local dev="$1" n="$2"
-    local base
-    base=$(basename "$dev")
-    if [[ "$base" == nvme* || "$base" == mmcblk* || "$base" == loop* || "$base" == md* || "$base" =~ [0-9]$ ]]; then
+    if [[ "$dev" == *nvme* ]]; then
         echo "${dev}p${n}"
     else
         echo "${dev}${n}"
     fi
 }
 
-nix_string() {
-    local value="$1"
-    value="${value//\\/\\\\}"
-    value="${value//\"/\\\"}"
-    value="${value//$'\n'/\\n}"
-    value="${value//$'\r'/\\r}"
-    value="${value//$'\t'/\\t}"
-    value="${value//\$\{/\\\$\{}"
-    printf '"%s"' "$value"
-}
-
 # ── Detect existing Bitcoin timechain data on data disk ───────────────────────
 if [[ -n "$DATA_DISK" ]]; then
     DATA_P1=$(part_suffix "$DATA_DISK" 1)
@@ -178,19 +142,12 @@ partprobe "$DISK"
 sleep 2
 
 # ── Step 2: Partition OS disk ─────────────────────────────────────────────────
-if [[ "$BOOT_MODE" == "uefi" ]]; then
-    log "=== Partitioning OS disk (UEFI) ==="
-    sgdisk \
-        -n "1:1M:+512M" -t "1:EF00" -c "1:ESP" \
-        -n "2:0:0"      -t "2:8300" -c "2:root" \
-        "$DISK"
-else
-    log "=== Partitioning OS disk (Legacy BIOS) ==="
-    sgdisk \
-        -n "1:1M:+1M" -t "1:EF02" -c "1:BIOS-boot" \
-        -n "2:0:0"    -t "2:8300" -c "2:root" \
-        "$DISK"
-fi
+log "=== Partitioning OS disk ==="
+
+sgdisk \
+    -n "1:1M:+512M" -t "1:EF00" -c "1:ESP" \
+    -n "2:0:0"      -t "2:8300" -c "2:root" \
+    "$DISK"
 
 partprobe "$DISK"
 sleep 2
@@ -211,11 +168,7 @@ log "=== Formatting partitions ==="
 BOOT_P1=$(part_suffix "$DISK" 1)
 BOOT_P2=$(part_suffix "$DISK" 2)
 
-if [[ "$BOOT_MODE" == "uefi" ]]; then
-    mkfs.vfat -F 32 "$BOOT_P1"
-else
-    log "Skipping ESP format for Legacy BIOS install"
-fi
+mkfs.vfat -F 32 "$BOOT_P1"
 mkfs.ext4 -F -L sovran_systemsos "$BOOT_P2"
 
 if [[ -n "$DATA_DISK" && "$DATA_DISK_HAS_TIMECHAIN" != true ]]; then
@@ -227,12 +180,8 @@ fi
 log "=== Mounting filesystems ==="
 
 mount "$BOOT_P2" /mnt
-if [[ "$BOOT_MODE" == "uefi" ]]; then
-    mkdir -p /mnt/boot/efi
-    mount -o umask=0077,defaults "$BOOT_P1" /mnt/boot/efi
-else
-    log "Legacy BIOS install: /boot/efi mount not required"
-fi
+mkdir -p /mnt/boot/efi
+mount -o umask=0077,defaults "$BOOT_P1" /mnt/boot/efi
 
 if [[ -n "$DATA_DISK" ]]; then
     DATA_P1=$(part_suffix "$DATA_DISK" 1)
@@ -270,41 +219,16 @@ case "$ROLE" in
         IS_SERVER=false; IS_DESKTOP=false; IS_NODE=true ;;
 esac
 
-{
-    cat <<EOF
+cat > /mnt/etc/nixos/role-state.nix <<EOF
 # THIS FILE IS AUTO-GENERATED BY THE INSTALLER. DO NOT EDIT.
 { config, lib, ... }:
 {
   sovran_systemsOS.roles.server_plus_desktop = lib.mkDefault ${IS_SERVER};
   sovran_systemsOS.roles.desktop = lib.mkDefault ${IS_DESKTOP};
   sovran_systemsOS.roles.node = lib.mkDefault ${IS_NODE};
+}
 EOF
 
-    if [[ "$BOOT_MODE" == "bios" ]]; then
-        GRUB_DEVICE=$(nix_string "$DISK")
-        cat <<EOF
-
-  # The installer ISO was booted in Legacy BIOS mode, so install GRUB to the
-  # target disk instead of using the default UEFI systemd-boot configuration.
-  boot.loader.systemd-boot.enable = lib.mkForce false;
-  boot.loader.efi.canTouchEfiVariables = lib.mkForce false;
-  boot.loader.grub.enable = lib.mkForce true;
-  boot.loader.grub.device = lib.mkForce ${GRUB_DEVICE};
-  fileSystems."/boot/efi".enable = lib.mkForce false;
-EOF
-    elif [[ -n "$VIRTUALIZATION" ]]; then
-        cat <<EOF
-
-  # VM UEFI firmware can reject or forget NVRAM boot-entry writes. Keep the
-  # normal UEFI systemd-boot layout, but use the fallback removable path instead
-  # of depending on EFI variable updates.
-  boot.loader.efi.canTouchEfiVariables = lib.mkForce false;
-EOF
-    fi
-
-    echo "}"
-} > /mnt/etc/nixos/role-state.nix
-
 # ── Step 10: Write custom.nix with deploy config ──────────────────────────────
 log "=== Writing custom.nix ==="
 

modules/core/caddy.nix

@@ -12,15 +12,11 @@ let
     || config.sovran_systemsOS.services.nextcloud
     || config.sovran_systemsOS.services.vaultwarden
     || config.sovran_systemsOS.features.haven
-    || config.sovran_systemsOS.features."nwc-wallets"
     || config.sovran_systemsOS.features.element-calling;
 in
 {
   services.caddy = {
-    # Only enable Caddy when at least one domain-based service needs it or
-    # the operator has defined custom vhosts.  This prevents Caddy from
-    # running on Desktop Only installs that have no web services configured.
-    enable = needsHttpsPorts || extraVhosts != "";
+    enable = true;
     user = "caddy";
     group = "root";
   };
@@ -71,7 +67,6 @@ in
       BTCPAY=$(read_domain btcpayserver)
       VAULTWARDEN=$(read_domain vaultwarden)
       HAVEN=$(read_domain haven)
-      LIGHTNING=$(read_domain lightning)
       ACME_EMAIL=$(read_domain sslemail)
 
       # Start with global config — use ACME only when domain-based services are active
@@ -188,20 +183,6 @@ $HAVEN {
 EOF
       fi
 
-      # ── Lightning Wallet Connections LNURL ──────────────────────
-      if [ -n "$LIGHTNING" ]; then
-        cat >> /run/caddy/Caddyfile <<EOF
-
-$LIGHTNING {
-  # LNURL discovery and callback are served by the dedicated
-  # nwc-lnurl service on loopback port 8181.  Only these paths
-  # are proxied; the Alby Hub management port (18080) is never exposed.
-  reverse_proxy /.well-known/lnurlp/* http://127.0.0.1:8181
-  reverse_proxy /lnurlp/* http://127.0.0.1:8181
-}
-EOF
-      fi
-
       # ── Sovran Hub (LAN access via mDNS) ────────────
       cat >> /run/caddy/Caddyfile <<EOF
 

modules/core/local-domain-loopback.nix

@@ -1,171 +0,0 @@
-{ config, pkgs, lib, ... }:
-
-# ── Server-local domain loopback overrides ────────────────────────────────────
-#
-# Some routers (especially newer ISP-provided devices) do not support NAT
-# loopback (hairpin NAT).  When a request originates on this computer and
-# targets a public domain name that resolves to the router's WAN address, the
-# router may refuse to loop the connection back in — causing Nextcloud, WordPress
-# background jobs, and other server-side callbacks to fail even when the service
-# is fully operational from the internet.
-#
-# This module installs a one-shot systemd service,
-# ``sovran-hosts-update.service``, that reads the configured service domains
-# from ``/var/lib/domains/`` at boot (and whenever triggered by the Hub after a
-# domain is saved) and writes ``127.0.0.1`` entries for them into a dedicated
-# Sovran-managed block in ``/etc/hosts``.
-#
-# With those entries in place:
-#   • Requests originating on this computer resolve the public domain name to
-#     127.0.0.1, reach Caddy directly, and never touch the router.
-#   • Caddy still receives the correct public hostname via TLS SNI so virtual-
-#     host routing and certificate validation continue to work.
-#   • The Sovran Hub can verify Caddy reachability locally without needing NAT
-#     loopback.
-#
-# Limitation: this does not help other devices on your home network (phones,
-# laptops).  Those devices resolve domains via the router's DNS and still depend
-# on NAT loopback (or require manual router DNS overrides).  For now, only
-# server-originated requests benefit from this override.
-#
-# On NixOS, /etc/hosts is normally a symlink into the Nix store and is
-# regenerated by the system activation script.  The ``system.activationScripts``
-# hook below converts it to a writable file each time the system is activated
-# (i.e. after every ``nixos-rebuild switch``) and then injects the Sovran block.
-# The same wrapped Nix-store executable is reused by both the activation hook
-# and the ``sovran-hosts-update.service`` unit, ensuring a deterministic runtime
-# PATH in every execution context.
-
-let
-  # ── Wrapped Nix-store executable ──────────────────────────────────────────
-  # Built with pkgs.writeShellApplication so that all required runtime tools
-  # (awk, grep, coreutils) are declared explicitly and injected into PATH by
-  # Nix.  Both the systemd service and the activation hook reference this same
-  # store-path executable — there is no second raw script body.
-  hostsUpdateScript = pkgs.writeShellApplication {
-    name = "sovran-hosts-update";
-
-    # Declare every external command the script calls.  These packages are
-    # added to the script's runtime PATH by writeShellApplication; nothing from
-    # the system PATH is relied upon.
-    runtimeInputs = [
-      pkgs.coreutils   # readlink, cp, mv, chmod, mktemp, rm, tr, head
-      pkgs.gawk        # awk
-      pkgs.gnugrep     # grep
-    ];
-
-    text = ''
-      # Regenerate the Sovran-managed loopback block in /etc/hosts.
-      # Safe to run multiple times — idempotent.
-
-      DOMAINS_DIR="/var/lib/domains"
-      HOSTS_FILE="/etc/hosts"
-      BEGIN_MARKER="# Sovran managed begin — server-local loopback overrides"
-      END_MARKER="# Sovran managed end"
-
-      # ── Step 1: ensure /etc/hosts is a regular writable file ──────────────
-      # On NixOS /etc/hosts starts as a symlink to the Nix store.  We replace
-      # it with a copy so we can append our block without touching the store.
-      if [ -L "$HOSTS_FILE" ]; then
-        TARGET=$(readlink -f "$HOSTS_FILE")
-        cp --no-preserve=all "$TARGET" "$HOSTS_FILE.sovran-tmp"
-        mv "$HOSTS_FILE.sovran-tmp" "$HOSTS_FILE"
-        chmod 644 "$HOSTS_FILE"
-      fi
-
-      # ── Step 2: remove any existing Sovran block ──────────────────────────
-      # Use a temp file so the operation is atomic.
-      # awk -v passes marker strings safely without shell interpolation.
-      TMP=$(mktemp "$HOSTS_FILE.XXXXXX")
-      trap 'rm -f "$TMP"' EXIT
-      awk -v begin="$BEGIN_MARKER" -v end="$END_MARKER" '
-        $0 == begin { skip=1; next }
-        $0 == end   { skip=0; next }
-        !skip
-      ' "$HOSTS_FILE" > "$TMP"
-
-      # ── Step 3: collect valid configured service domains ──────────────────
-      # NOTE: The hostname validation regex below must stay in sync with
-      # _SAFE_DOMAIN_RE in app/sovran_systemsos_web/server.py.
-      ENTRIES=""
-      for KEY in matrix wordpress nextcloud btcpayserver vaultwarden haven element-calling lightning; do
-        FILE="$DOMAINS_DIR/$KEY"
-        [ -f "$FILE" ] || continue
-        # Read the domain value (strip all whitespace, limit to 253 chars)
-        DOMAIN=$(tr -d '[:space:]' < "$FILE" | head -c 253)
-        [ -z "$DOMAIN" ] && continue
-        # Validate: must match a reasonable hostname pattern (no injection)
-        if ! printf '%s' "$DOMAIN" | grep -qE \
-          '^[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+$'; then
-          echo "sovran-hosts-update: skipping invalid domain value for $KEY: $DOMAIN" >&2
-          continue
-        fi
-        ENTRIES="$ENTRIES
-127.0.0.1 $DOMAIN
-::1       $DOMAIN"
-      done
-
-      # ── Step 4: append the Sovran block if there are any entries ──────────
-      if [ -n "$ENTRIES" ]; then
-        {
-          printf '\n%s\n' "$BEGIN_MARKER"
-          printf '%s\n' "# These entries route configured service domains to local Caddy."
-          printf '%s\n' "# They are managed automatically — do not edit this block."
-          printf '%s\n' "$ENTRIES"
-          printf '%s\n' "$END_MARKER"
-        } >> "$TMP"
-      fi
-
-      # ── Step 5: atomically replace /etc/hosts ─────────────────────────────
-      mv "$TMP" "$HOSTS_FILE"
-      chmod 644 "$HOSTS_FILE"
-    '';
-  };
-
-in
-{
-  # ── /etc/sovran-hosts-update.sh — operator discoverability symlink ─────────
-  # Retain the familiar /etc path so administrators can inspect or manually
-  # invoke the helper.  The target is the wrapped Nix-store executable, so
-  # there is no second raw script body to keep in sync.
-  environment.etc."sovran-hosts-update.sh".source = lib.getExe hostsUpdateScript;
-
-  # ── Systemd service ────────────────────────────────────────────────────────
-
-  systemd.services.sovran-hosts-update = {
-    description = "Update /etc/hosts with Sovran server-local loopback overrides";
-    documentation = [ "https://github.com/naturallaw777/sovran-systems" ];
-
-    # Run before Caddy so loopback entries are ready when it starts.
-    before = [
-      "caddy.service"
-      "network-online.target"
-    ];
-    wantedBy = [ "multi-user.target" ];
-
-    serviceConfig = {
-      Type = "oneshot";
-      RemainAfterExit = true;
-      # Point directly at the wrapped Nix-store executable, not the /etc path.
-      ExecStart = lib.getExe hostsUpdateScript;
-    };
-  };
-
-  # ── Activation script (runs after every nixos-rebuild switch) ─────────────
-  # This ensures the loopback block survives rebuilds that restore the /etc/hosts
-  # symlink.  The "users" and "etc" scripts must complete first.
-  # The same wrapped Nix-store executable used by the systemd service is
-  # referenced here, guaranteeing identical runtime dependencies in both
-  # execution contexts.
-
-  system.activationScripts.sovranDomainLoopback = {
-    text = ''
-      if [ -d /var/lib/domains ]; then
-        if ! ${lib.getExe hostsUpdateScript}; then
-          echo "warning: sovran-hosts-update: failed to update /etc/hosts loopback entries" >&2
-        fi
-      fi
-    '';
-    deps = [ "etc" "users" ];
-  };
-}

modules/core/role-logic.nix

@@ -3,13 +3,6 @@
 {
   config = lib.mkMerge [
 
-    # nix-bitcoin is globally imported by the flake (nixosModules.Sovran_SystemsOS).
-    # This default satisfies nix-bitcoin's generateSecrets assertion so that Desktop
-    # Only systems can evaluate without enabling any Bitcoin services.
-    {
-      nix-bitcoin.generateSecrets = lib.mkDefault true;
-    }
-
     # ── Server+Desktop Role (default) ─────────────────────────
     (lib.mkIf config.sovran_systemsOS.roles.server_plus_desktop {
       sovran_systemsOS.web.btcpayserver = lib.mkDefault true;
@@ -19,25 +12,15 @@
     (lib.mkIf config.sovran_systemsOS.roles.desktop {
       services.desktopManager.gnome.enable = true;
 
-      # Force all server/node services and features off so they cannot be
-      # accidentally enabled via custom.nix or option defaults on Desktop Only.
       sovran_systemsOS.services = {
-        synapse = lib.mkForce false;
-        bitcoin = lib.mkForce false;
-        vaultwarden = lib.mkForce false;
-        wordpress = lib.mkForce false;
-        nextcloud = lib.mkForce false;
+        synapse = lib.mkDefault false;
+        bitcoin = lib.mkDefault false;
+        vaultwarden = lib.mkDefault false;
+        wordpress = lib.mkDefault false;
+        nextcloud = lib.mkDefault false;
       };
 
-      sovran_systemsOS.features = {
-        haven = lib.mkForce false;
-        mempool = lib.mkForce false;
-        element-calling = lib.mkForce false;
-        bitcoin-core = lib.mkForce false;
-        "nwc-wallets" = lib.mkForce false;
-      };
-
-      sovran_systemsOS.web.btcpayserver = lib.mkForce false;
+      sovran_systemsOS.web.btcpayserver = lib.mkDefault false;
     })
 
     # ── Bitcoin Node Only Role ────────────────────────────────

modules/core/roles.nix

@@ -46,7 +46,6 @@
       mempool = lib.mkEnableOption "Bitcoin Mempool Explorer";
       element-calling = lib.mkEnableOption "Element Video and Audio Calling";
       bitcoin-core = lib.mkEnableOption "Bitcoin Core";
-      "nwc-wallets" = lib.mkEnableOption "Lightning Wallet Connections";
       rdp = lib.mkEnableOption "Gnome Remote Desktop";
       sshd = lib.mkEnableOption "SSH remote access";
 

modules/core/sovran-hub.nix

@@ -3,16 +3,6 @@
 let
   cfg = config.sovran_systemsOS;
 
-  # Read the OS version from the repo-root VERSION file at eval time so the
-  # Hub always ships a real, baked-in version string instead of relying on
-  # a runtime file lookup (which returns "dev" when /etc/nixos/VERSION is
-  # missing, e.g. in a dev checkout — this is the "vdev" bug in the Hub UI).
-  versionFile = ../../VERSION;
-  sovranVersion =
-    if builtins.pathExists versionFile
-    then builtins.replaceStrings [ "v" "\n" "\r" ] [ "" "" "" ] (builtins.readFile versionFile)
-    else "1.0.0";
-
   monitoredServices =
     # ── Infrastructure — System Passwords (always present) ─────
     [
@@ -65,14 +55,12 @@ let
       ]; }
       { name = "Zeus Connect";       unit = "zeus-connect-setup.service"; type = "system"; icon = "zeus";   enabled = cfg.services.bitcoin;  category = "bitcoin-apps"; credentials = [
         { label = "QR Code"; file = "/var/lib/secrets/zeus-connect-url"; qrcode = true; qronly = true; }
+        { label = "How to Connect"; value = "1. Download Zeus from App Store or Google Play\n2. Open Zeus → Scan Node Config\n3. Scan the QR code above"; }
       ]; }
       { name = "Sparrow Auto-Link"; unit = "sparrow-autoconnect.service"; type = "system"; icon = "sparrow"; enabled = cfg.services.bitcoin; category = "bitcoin-apps"; credentials = [
         { label = "Server"; value = "tcp://127.0.0.1:50001 (Electrs)"; }
         { label = "Status"; value = "Auto-configured on first boot"; }
       ]; }
-      { name = "Lightning Wallet Connections"; unit = "albyhub.service"; type = "system"; icon = "nwc"; enabled = cfg.features."nwc-wallets"; category = "bitcoin-apps"; credentials = [
-        { label = "Lightning Address Domain"; file = "/var/lib/domains/lightning"; }
-      ]; }
       { name = "Mempool";            unit = "mempool.service";      type = "system"; icon = "mempool";      enabled = cfg.features.mempool;  category = "bitcoin-apps"; credentials = [
         { label = "Tor Address — Access from anywhere via Tor Browser"; file = "/var/lib/tor/onion/mempool-frontend/hostname"; prefix = "http://"; }
         { label = "Local Network — Access on your home network only"; file = "/var/lib/secrets/internal-ip"; prefix = "http://"; suffix = ":60847"; }
@@ -88,7 +76,7 @@ let
         { label = "Test Username";    file = "/var/lib/secrets/matrix-test-username"; }
         { label = "Test Password";    file = "/var/lib/secrets/matrix-test-password"; }
       ]; }
-      { name = "LiveKit (Element Call)"; unit = "livekit.service"; type = "system"; icon = "element-calling"; enabled = cfg.features.element-calling; category = "communication"; credentials = []; }
+      { name = "Element-Call";   unit = "livekit.service";        type = "system"; icon = "element-calling"; enabled = cfg.features.element-calling;  category = "communication"; credentials = []; }
     ]
     # ── Self-Hosted Apps (server+desktop only) ─────────────────
     ++ lib.optionals cfg.roles.server_plus_desktop [
@@ -125,28 +113,8 @@ let
       role             = activeRole;
       services         = monitoredServices;
       feature_manager  = true;
-      sovran_version   = sovranVersion;
     });
 
-  generatedVersions = pkgs.writeText "sovran-hub-versions.json" (builtins.toJSON {
-    "caddy.service" = if pkgs ? caddy then pkgs.caddy.version else "2.8.4";
-    "tor.service" = if pkgs ? tor then pkgs.tor.version else "0.4.8.12";
-    "gnome-remote-desktop.service" = if pkgs ? gnome-remote-desktop then pkgs.gnome-remote-desktop.version else "46.0";
-    "bitcoind.service" = if pkgs ? bitcoind-knots then pkgs.bitcoind-knots.version else (if pkgs ? bitcoind then pkgs.bitcoind.version else "27.1.0");
-    "electrs.service" = if pkgs ? electrs then pkgs.electrs.version else "0.10.6";
-    "lnd.service" = if pkgs ? lnd then pkgs.lnd.version else "0.18.0";
-    "rtl.service" = if pkgs ? clightning-rtl then pkgs.clightning-rtl.version else (if pkgs ? rtl then pkgs.rtl.version else "0.15.2");
-    "btcpayserver.service" = if pkgs ? btcpayserver then pkgs.btcpayserver.version else "2.0.0";
-    "albyhub.service" = if pkgs ? albyhub then pkgs.albyhub.version else "1.8.0";
-    "mempool.service" = if pkgs ? mempool then pkgs.mempool.version else "3.0.0";
-    "matrix-synapse.service" = if pkgs ? matrix-synapse then pkgs.matrix-synapse.version else "1.115.0";
-    "livekit.service" = if pkgs ? livekit then pkgs.livekit.version else "1.5.2";
-    "vaultwarden.service" = if pkgs ? vaultwarden then pkgs.vaultwarden.version else "1.32.0";
-    # Nextcloud and WordPress are downloaded into /var/lib/www, so their
-    # deployed versions are read from their own PHP version files by the Hub.
-    "haven-relay.service" = if pkgs ? haven-relay then pkgs.haven-relay.version else (if pkgs ? haven then pkgs.haven.version else "0.1.0");
-  });
-
   # ── Update wrapper script ──────────────────────────────────────
   update-script = pkgs.writeShellScript "sovran-hub-update.sh" ''
     set -uo pipefail
@@ -178,16 +146,33 @@ let
     echo ""
 
     if [ "$RC" -eq 0 ]; then
-      echo "── Step 2/3: nixos-rebuild boot (stage next reboot) ──"
-      BOOT_OUT=$(nixos-rebuild boot --flake /etc/nixos --print-build-logs \
+      echo "── Step 2/3: nixos-rebuild ──────────────────────────"
+      SWITCH_OUT=$(nixos-rebuild switch --flake /etc/nixos --print-build-logs \
         --option connect-timeout 10 \
         --option stalled-download-timeout 90 \
         --option download-attempts 7 \
         --option fallback true 2>&1)
-      BOOT_RC=$?
-      echo "$BOOT_OUT"
-      if [ "$BOOT_RC" -ne 0 ]; then
-        echo "[ERROR] nixos-rebuild boot failed"
+      SWITCH_RC=$?
+      echo "$SWITCH_OUT"
+      if [ "$SWITCH_RC" -eq 0 ]; then
+        echo "[OK] switch succeeded"
+      elif echo "$SWITCH_OUT" | grep -q "switchInhibitors\|Pre-switch checks failed"; then
+        echo ""
+        echo "  ✓ Build succeeded — a reboot is required to apply this update"
+        echo "  (Critical system components changed; running nixos-rebuild boot instead)"
+        if nixos-rebuild boot --flake /etc/nixos --print-build-logs \
+             --option connect-timeout 10 \
+             --option stalled-download-timeout 90 \
+             --option download-attempts 7 \
+             --option fallback true 2>&1; then
+          echo "REBOOT_REQUIRED" > "$STATUS"
+          exit 0
+        else
+          echo "[ERROR] nixos-rebuild boot also failed"
+          RC=1
+        fi
+      else
+        echo "[ERROR] nixos-rebuild switch failed"
         RC=1
       fi
       echo ""
@@ -203,10 +188,9 @@ let
 
     if [ "$RC" -eq 0 ]; then
       echo "══════════════════════════════════════════════════"
-      echo "  ✓ Update staged successfully"
-      echo "  Reboot required to activate the new system"
+      echo "  ✓ Update completed successfully"
       echo "══════════════════════════════════════════════════"
-      echo "REBOOT_REQUIRED" > "$STATUS"
+      echo "SUCCESS" > "$STATUS"
     else
       echo "══════════════════════════════════════════════════"
       echo "  ✗ Update failed — see errors above"
@@ -340,8 +324,6 @@ let
       cp -r sovran_systemsos_web $out/lib/sovran-hub-web/
 
       cp ${generatedConfig} $out/lib/sovran-hub-web/config.json
-      cp ${generatedVersions} $out/lib/sovran-hub-web/versions.json
-      printf '%s' "${sovranVersion}" > $out/lib/sovran-hub-web/VERSION
 
       install -d $out/share/sovran-hub/icons
       cp icons/* $out/share/sovran-hub/icons/ 2>/dev/null || true
@@ -376,7 +358,6 @@ import os, sys
 base = os.path.join("$out", "lib", "sovran-hub-web")
 sys.path.insert(0, base)
 os.environ["SOVRAN_HUB_CONFIG"] = os.path.join(base, "config.json")
-os.environ["SOVRAN_HUB_VERSIONS"] = os.path.join(base, "versions.json")
 os.environ["SOVRAN_HUB_ICONS"]  = os.path.join("$out", "share", "sovran-hub", "icons")
 import uvicorn
 uvicorn.run(
@@ -388,26 +369,6 @@ uvicorn.run(
 LAUNCHER
       chmod +x $out/bin/sovran-hub-web
 
-      cat > $out/bin/nwc-wallet <<LAUNCHER
-#!${pkgs.python3}/bin/python3
-import os, sys
-base = os.path.join("$out", "lib", "sovran-hub-web")
-sys.path.insert(0, base)
-from sovran_systemsos_web.nwc_wallet_cli import main
-sys.exit(main())
-LAUNCHER
-      chmod +x $out/bin/nwc-wallet
-
-      cat > $out/bin/nwc-lnurl <<LAUNCHER
-#!${pkgs.python3}/bin/python3
-import os, sys
-base = os.path.join("$out", "lib", "sovran-hub-web")
-sys.path.insert(0, base)
-from sovran_systemsos_web.nwc_lnurl_service import main
-main()
-LAUNCHER
-      chmod +x $out/bin/nwc-lnurl
-
       runHook postInstall
     '';
 
@@ -419,12 +380,6 @@ LAUNCHER
 
 in
 {
-  options.services.sovranHub.webPackage = lib.mkOption {
-    type        = lib.types.package;
-    default     = sovran-hub-web;
-    description = "The sovran-hub-web Python application package. Other modules use this to reference Hub-installed scripts without duplicating the Python path setup.";
-  };
-
   config = {
     systemd.services.sovran-hub-web = {
       description = "Sovran_SystemsOS Hub Web Interface";
@@ -443,25 +398,13 @@ in
       };
 
       path = [
-        pkgs.bash
-        pkgs.gawk
         pkgs.qrencode
         pkgs.curl
         pkgs.iproute2
         pkgs.nftables
         pkgs.iptables
         pkgs.hostname
-        pkgs.coreutils
-        pkgs.findutils
-        pkgs.gnugrep
-        pkgs.rsync
-        pkgs.acl
-        pkgs.util-linux
-      ]
-      ++ lib.optional cfg.services.bitcoin config.services.bitcoind.package
-      ++ lib.optionals cfg.services.bitcoin [ pkgs.lnd ]
-      ++ lib.optionals (cfg.services.nextcloud || cfg.services.synapse) [ config.services.postgresql.package ]
-      ++ lib.optionals config.services.mysql.enable [ config.services.mysql.package ];
+      ] ++ lib.optional cfg.services.bitcoin config.services.bitcoind.package;
     };
 
     systemd.services.sovran-hub-update = {

modules/core/ssh-bootstrap.nix

@@ -31,7 +31,7 @@ lib.mkIf userExists {
   };
 
   systemd.services.factory-ssh-keygen = {
-    description = "Generate or repair factory SSH key for ${userName}";
+    description = "Generate factory SSH key for ${userName} if missing";
     wantedBy = [ "multi-user.target" ];
     after = [ "ssh-passphrase-setup.service" ];
     requires = [ "ssh-passphrase-setup.service" ];
@@ -39,47 +39,14 @@ lib.mkIf userExists {
       Type = "oneshot";
       RemainAfterExit = true;
     };
-    path = [ pkgs.openssh pkgs.coreutils pkgs.util-linux ];
+    path = [ pkgs.openssh pkgs.coreutils ];
     script = ''
-      set -eu
-
-      PASSPHRASE=$(cat /var/lib/secrets/ssh-passphrase)
-      lock_file="${keyPath}.lock"
-
-      exec 9>"$lock_file"
-
-      if ! flock -n 9; then
-        echo "Factory SSH key setup is already running." >&2
-        exit 1
-      fi
-
-      generate_factory_key() {
+      if [ ! -f "${keyPath}" ]; then
+        PASSPHRASE=$(cat /var/lib/secrets/ssh-passphrase)
         ssh-keygen -q -N "$PASSPHRASE" -t ed25519 -f "${keyPath}"
         chown ${userName}:users "${keyPath}" "${keyPath}.pub"
         chmod 600 "${keyPath}"
         chmod 644 "${keyPath}.pub"
-      }
-
-      if [ ! -f "${keyPath}" ]; then
-        generate_factory_key
-      elif ! ssh-keygen -y -P "$PASSPHRASE" -f "${keyPath}" >/dev/null 2>&1; then
-        backup_suffix="$(date -u +%Y%m%d_%H%M%S)-$$"
-        backup_path="${keyPath}.bak-$backup_suffix"
-        backup_index=0
-
-        while [ -e "$backup_path" ] || [ -e "$backup_path.pub" ]; do
-          backup_index=$((backup_index + 1))
-          backup_path="${keyPath}.bak-$backup_suffix-$backup_index"
-        done
-
-        echo "Existing factory SSH key does not match current passphrase; backing it up to $backup_path and generating a replacement."
-        mv "${keyPath}" "$backup_path"
-
-        if [ -f "${keyPath}.pub" ]; then
-          mv "${keyPath}.pub" "$backup_path.pub"
-        fi
-
-        generate_factory_key
       fi
     '';
   };

modules/credentials.nix

@@ -111,15 +111,7 @@ in
         echo "$ROOT_PASS" > "$SECRET_FILE"
         chmod 600 "$SECRET_FILE"
       fi
-      # If the file contains a scrypt hash (salt:hash), skip chpasswd — the
-      # password was already set via the Hub security reset endpoint and this
-      # service is only re-running as a manual recovery step.
-      CONTENT="$(cat "$SECRET_FILE")"
-      if echo "$CONTENT" | grep -qE '^[0-9a-f]{32}:[0-9a-f]{64,}$'; then
-        echo "root-password-setup: stored value is already hashed — skipping chpasswd" >&2
-      else
-        echo "root:$CONTENT" | chpasswd
-      fi
+      echo "root:$(cat "$SECRET_FILE")" | chpasswd
     '';
   };
 

modules/element-calling.nix

@@ -34,8 +34,8 @@ lib.mkIf config.sovran_systemsOS.features.element-calling {
   };
 
   ####### ENSURE SERVICES START AFTER KEY EXISTS #######
-  systemd.services.livekit.after = [ "livekit-key-setup.service" "livekit-turn-setup.service" ];
-  systemd.services.livekit.wants = [ "livekit-key-setup.service" "livekit-turn-setup.service" ];
+  systemd.services.livekit.after = [ "livekit-key-setup.service" ];
+  systemd.services.livekit.wants = [ "livekit-key-setup.service" ];
   systemd.services.lk-jwt-service.after = [ "livekit-key-setup.service" ];
   systemd.services.lk-jwt-service.wants = [ "livekit-key-setup.service" ];
 
@@ -72,50 +72,28 @@ $MATRIX {
 }
 
 $ELEMENT_CALLING {
-  # Route all current lk-jwt-service authorization endpoints to port 8073,
-  # stripping the /livekit/jwt prefix that Caddy adds on the public URL.
-  @lk_jwt path /livekit/jwt/sfu/get* /livekit/jwt/get_token* /livekit/jwt/healthz* /livekit/jwt/sfu_webhook* /livekit/jwt/delegate_delayed_leave*
-  handle @lk_jwt {
+  handle /livekit/jwt/sfu/get {
     uri strip_prefix /livekit/jwt
     reverse_proxy [::1]:8073 {
       header_up Host {host}
       header_up X-Forwarded-Server {host}
       header_up X-Real-IP {remote_host}
       header_up X-Forwarded-For {remote_host}
-      header_up X-Forwarded-Proto {scheme}
     }
   }
   handle {
-    reverse_proxy localhost:7880 {
-      header_up Host {host}
-      header_up X-Forwarded-Proto {scheme}
-      header_up X-Forwarded-For {remote_host}
-      header_up X-Real-IP {remote_host}
-      transport http {
-        read_timeout 300s
-        write_timeout 300s
-      }
-    }
+    reverse_proxy localhost:7880
   }
 }
 EOF
     '';
   };
 
-  ####### LIVEKIT TURN SETUP (runtime cert + config) #######
-  # Replaces the old dead livekit-runtime-config.service. At runtime this:
-  #   * reads the matrix domain from /var/lib/domains/matrix (never hardcoded)
-  #   * copies Caddy's already-issued matrix cert/key into /var/lib/livekit
-  #     so LoadCredential can stage them for the (DynamicUser) livekit unit
-  #   * detects the primary network interface from the IPv4 default route so
-  #     LiveKit only advertises real ICE candidates — not VPN/container/private
-  #     addresses from interfaces like Tailscale or Docker bridges
-  #   * writes a complete LiveKit config (with turn.domain and interface
-  #     substituted) that the overridden ExecStart loads.
-  systemd.services.livekit-turn-setup = {
-    description = "Stage TURN cert and generate LiveKit runtime config from domain files";
-    after = [ "caddy.service" "livekit-key-setup.service" ];
+  ####### LIVEKIT RUNTIME CONFIG #######
+  systemd.services.livekit-runtime-config = {
+    description = "Generate LiveKit runtime config from domain files";
     before = [ "livekit.service" ];
+    after = [ "livekit-key-setup.service" ];
     requiredBy = [ "livekit.service" ];
     wantedBy = [ "multi-user.target" ];
     serviceConfig = {
@@ -125,63 +103,20 @@ EOF
     unitConfig = {
       ConditionPathExists = "/var/lib/domains/element-calling";
     };
-    path = [ pkgs.coreutils pkgs.findutils pkgs.iproute2 pkgs.gawk ];
+    path = [ pkgs.coreutils ];
     script = ''
       MATRIX=$(cat /var/lib/domains/matrix)
 
       mkdir -p /run/livekit
 
-      # Copy Caddy's already-issued matrix cert/key into LiveKit's state dir.
-      # The ACME CA hostname directory can vary, so glob for the domain dir.
-      CRT=$(find /var/lib/caddy -path "*/$MATRIX/$MATRIX.crt" | head -n1)
-      KEY=$(find /var/lib/caddy -path "*/$MATRIX/$MATRIX.key" | head -n1)
-      cp "$CRT" /var/lib/livekit/turn.crt
-      cp "$KEY" /var/lib/livekit/turn.key
-      chmod 640 /var/lib/livekit/turn.crt /var/lib/livekit/turn.key
-
-      # Detect the primary network interface from the IPv4 default route.
-      # Restricting LiveKit to this single interface prevents it from
-      # advertising VPN/container/private ICE candidates (e.g. Tailscale,
-      # Docker bridges) that remote peers cannot reach, which causes all
-      # ICE negotiation attempts to fail with responsesReceived: 0.
-      IFACE=$(ip -4 route show default | awk '/^default/ { for(i=1;i<=NF;i++) if($i=="dev" && (i+1)<=NF) { print $(i+1); exit } }')
-      if [ -z "$IFACE" ]; then
-        echo "ERROR: Could not detect a default-route network interface from 'ip -4 route show default'." >&2
-        echo "ERROR: Cannot generate a valid LiveKit config without a real interface to bind ICE candidates to." >&2
-        echo "ERROR: Ensure a default IPv4 route is configured, e.g.: ip route add default via <gateway> dev <interface>" >&2
-        echo "ERROR: Inspect the current routing table with: ip -4 route show" >&2
-        exit 1
-      fi
-      echo "Detected primary network interface: $IFACE"
-
-      # Generate the full LiveKit config the daemon will load. turn.domain and
-      # rtc.interfaces.includes are only known at runtime, so they are
-      # substituted here. The cert/key paths point at the LoadCredential-staged
-      # copies under /run/credentials.
-      cat > /run/livekit/livekit.yaml <<EOF
-port: 7880
-rtc:
-  use_external_ip: true
-  skip_external_ip_validation: true
-  tcp_port: 7881
-  udp_port: 7882
-  port_range_start: 30000
-  port_range_end: 40000
-  interfaces:
-    includes:
-      - $IFACE
-room:
-  auto_create: false
+      cat > /run/livekit/runtime-config.yaml <<EOF
 turn:
-  enabled: true
   domain: $MATRIX
-  tls_port: 5349
-  udp_port: 3478
-  cert_file: /run/credentials/livekit.service/turn-cert
-  key_file: /run/credentials/livekit.service/turn-key
+  cert_file: /var/lib/livekit/$MATRIX.crt
+  key_file: /var/lib/livekit/$MATRIX.key
 EOF
 
-      chmod 644 /run/livekit/livekit.yaml
+      chmod 640 /run/livekit/runtime-config.yaml
     '';
   };
 
@@ -192,11 +127,7 @@ EOF
     keyFile = livekitKeyFile;
     settings = {
       rtc.use_external_ip = true;
-      rtc.skip_external_ip_validation = true;
-      rtc.tcp_port = 7881;
       rtc.udp_port = 7882;
-      rtc.port_range_start = 30000;
-      rtc.port_range_end = 40000;
       room.auto_create = false;
       turn = {
         enabled = true;
@@ -206,29 +137,15 @@ EOF
     };
   };
 
-  # Override ExecStart to load the runtime-generated config (which carries the
-  # runtime-only turn.domain), mirroring the Caddy ExecStart override pattern in
-  # modules/core/caddy.nix. Deliver the TURN cert/key via LoadCredential so they
-  # are readable under the upstream unit's DynamicUser=true sandbox without
-  # weakening it. Everything else about the standard unit is left intact.
-  systemd.services.livekit.serviceConfig.ExecStart = lib.mkForce [
-    ""
-    "${pkgs.livekit}/bin/livekit-server --config /run/credentials/livekit.service/livekit-config --key-file /run/credentials/livekit.service/livekit-secrets"
-  ];
-
-  systemd.services.livekit.serviceConfig.LoadCredential = [
-    "livekit-config:/run/livekit/livekit.yaml"
-    "livekit-secrets:${livekitKeyFile}"
-    "turn-cert:/var/lib/livekit/turn.crt"
-    "turn-key:/var/lib/livekit/turn.key"
-  ];
-
   networking.firewall.allowedTCPPorts = [ 5349 7881 ];
   networking.firewall.allowedUDPPorts = [ 3478 7882 ];
   networking.firewall.allowedUDPPortRanges = [
-    { from = 30000; to = 40000; } # LiveKit internal TURN relay range
+    { from = 30000; to = 40000; }
   ];
-
+  networking.firewall.allowedTCPPortRanges = [
+    { from = 30000; to = 40000; }
+  ];
+  
   ####### JWT SERVICE RUNTIME CONFIG #######
   systemd.services.lk-jwt-service-runtime-config = {
     description = "Generate lk-jwt-service runtime config from domain files";
@@ -246,13 +163,11 @@ EOF
     path = [ pkgs.coreutils ];
     script = ''
       ELEMENT_CALLING=$(cat /var/lib/domains/element-calling)
-      MATRIX=$(cat /var/lib/domains/matrix)
 
       mkdir -p /run/lk-jwt-service
 
       cat > /run/lk-jwt-service/env <<EOF
 LIVEKIT_URL=wss://$ELEMENT_CALLING
-LIVEKIT_FULL_ACCESS_HOMESERVERS=$MATRIX
 EOF
 
       chmod 640 /run/lk-jwt-service/env

modules/modules.nix

@@ -16,7 +16,6 @@
     ./core/remote-deploy.nix
     ./core/no-sleep.nix
     ./core/cpu-performance.nix
-    ./core/local-domain-loopback.nix
 
     # ── Always on (no flag) ───────────────────────────────────
     ./php.nix
@@ -32,7 +31,6 @@
 
     # ── Features (default OFF — enable in custom.nix) ─────────
     ./haven.nix
-    ./nwc-wallets.nix
     ./element-calling.nix
     ./mempool.nix
     ./bitcoin-core.nix

modules/nwc-wallets.nix

@@ -1,182 +0,0 @@
-{ config, pkgs, lib, ... }:
-
-let
-  albyHubPort = 18080;
-  albyHubApiBase = "http://127.0.0.1:${toString albyHubPort}";
-  patchedAlbyHub = pkgs.albyhub.overrideAttrs (old: {
-    patches = (old.patches or []) ++ [
-      ../packages/albyhub/0001-private-route-hints.patch
-      ../packages/albyhub/0002-isolated-invoice-app-id.patch
-      ../packages/albyhub/0003-loopback-bind-host.patch
-    ];
-  });
-
-  lndRpcAddress = lib.attrByPath [ "services" "lnd" "rpcAddress" ] "127.0.0.1" config;
-  lndRpcPort = toString (lib.attrByPath [ "services" "lnd" "rpcPort" ] 10009 config);
-  lndCertPath = config.services.lnd.certPath;
-  pythonManagerEnvironment = {
-    NWC_ALBY_HUB_API_BASE = albyHubApiBase;
-    NWC_LND_ADDRESS = "${lndRpcAddress}:${lndRpcPort}";
-    NWC_LND_CERT_FILE = lndCertPath;
-    NWC_LND_MACAROON_FILE = "/run/lnd/albyhub.macaroon";
-    NWC_RELAY =
-      if config.sovran_systemsOS.features.haven
-      then "wss://haven.${config.networking.domain}/nostr"
-      else "wss://relay.getalby.com,wss://relay2.getalby.com";
-  };
-  wrappedNwcWallet = lib.hiPrio (pkgs.writeShellScriptBin "nwc-wallet" ''
-    export NWC_ALBY_HUB_API_BASE='${pythonManagerEnvironment.NWC_ALBY_HUB_API_BASE}'
-    export NWC_LND_ADDRESS='${pythonManagerEnvironment.NWC_LND_ADDRESS}'
-    export NWC_LND_CERT_FILE='${pythonManagerEnvironment.NWC_LND_CERT_FILE}'
-    export NWC_LND_MACAROON_FILE='${pythonManagerEnvironment.NWC_LND_MACAROON_FILE}'
-    export NWC_RELAY='${pythonManagerEnvironment.NWC_RELAY}'
-    exec ${config.services.sovranHub.webPackage}/bin/nwc-wallet "$@"
-  '');
-
-  albyhubWrapper = pkgs.writeShellScript "albyhub-wrapper" ''
-    set -euo pipefail
-    password_file="/var/lib/albyhub/unlock-password"
-    if [ ! -s "$password_file" ]; then
-      umask 077
-      ${pkgs.openssl}/bin/openssl rand -hex 32 > "$password_file"
-    fi
-    export AUTO_UNLOCK_PASSWORD="$(cat "$password_file")"
-    exec ${lib.getExe patchedAlbyHub}
-  '';
-in
-lib.mkIf config.sovran_systemsOS.features."nwc-wallets" {
-  assertions = [
-    {
-      assertion = config.services.lnd.enable;
-      message = "Lightning Wallet Connections requires services.lnd.enable = true.";
-    }
-    {
-      assertion = !(lib.attrByPath [ "nix-bitcoin" "netns-isolation" "enable" ] false config);
-      message = "Lightning Wallet Connections requires nix-bitcoin.netns-isolation.enable = false.";
-    }
-    {
-      assertion = albyHubPort != config.services.lnd.restPort;
-      message = "Alby Hub and LND REST must use different ports.";
-    }
-    {
-      assertion = albyHubPort != 8181;
-      message = "Alby Hub and the public LNURL service must use different ports.";
-    }
-    {
-      assertion = !(lib.elem albyHubPort config.networking.firewall.allowedTCPPorts);
-      message = "Alby Hub management port must not be opened on the public TCP firewall.";
-    }
-  ];
-
-  users.groups.albyhub = { };
-  users.users.albyhub = {
-    isSystemUser = true;
-    group = "albyhub";
-    home = "/var/lib/albyhub";
-    createHome = false;
-    extraGroups = [ ];
-  };
-
-  systemd.tmpfiles.rules = [
-    "d /var/lib/albyhub       0700 albyhub albyhub -"
-  ];
-
-  services.lnd.macaroons.albyhub = {
-    user = "albyhub";
-    permissions = lib.concatStringsSep "," [
-      ''{"entity":"info","action":"read"}''
-      ''{"entity":"offchain","action":"read"}''
-      ''{"entity":"offchain","action":"write"}''
-      ''{"entity":"invoices","action":"read"}''
-      ''{"entity":"invoices","action":"write"}''
-      ''{"entity":"onchain","action":"read"}''
-      ''{"entity":"address","action":"read"}''
-      ''{"entity":"message","action":"read"}''
-      ''{"entity":"message","action":"write"}''
-    ];
-  };
-
-  systemd.services.albyhub = {
-    description = "Alby Hub — NWC wallet server";
-    wantedBy = [ "multi-user.target" ];
-    after = [ "network.target" "lnd.service" ];
-    requires = [ "lnd.service" ];
-
-    environment = {
-      HOME = "/var/lib/albyhub";
-      HOST = "127.0.0.1";
-      LN_BACKEND_TYPE = "LND";
-      ENABLE_ADVANCED_SETUP = "false";
-      LND_ADDRESS = "${lndRpcAddress}:${lndRpcPort}";
-      LND_CERT_FILE = lndCertPath;
-      LND_MACAROON_FILE = "/run/lnd/albyhub.macaroon";
-      WORK_DIR = "/var/lib/albyhub";
-      DATABASE_URI = "/var/lib/albyhub/nwc.db";
-      PORT = toString albyHubPort;
-      # Use private Nostr relay if Haven is enabled, otherwise default to Alby's public relays
-      RELAY =
-        if config.sovran_systemsOS.features.haven
-        then "wss://haven.${config.networking.domain}/nostr"
-        else "wss://relay.getalby.com,wss://relay2.getalby.com";
-      AUTO_LINK_ALBY_ACCOUNT = "false";
-      SEND_EVENTS_TO_ALBY = "false";
-      LOG_TO_FILE = "false";
-      HIDE_UPDATE_BANNER = "true";
-    };
-
-    serviceConfig = {
-      Type = "simple";
-      User = "albyhub";
-      Group = "albyhub";
-      WorkingDirectory = "/var/lib/albyhub";
-      ExecStart = albyhubWrapper;
-      Restart = "on-failure";
-      RestartSec = "10s";
-      UMask = "0077";
-      NoNewPrivileges = true;
-      PrivateTmp = true;
-      ProtectHome = true;
-      ProtectSystem = "strict";
-      ReadWritePaths = [ "/var/lib/albyhub" ];
-      ReadOnlyPaths = [ lndCertPath "/run/lnd" ];
-    };
-  };
-
-  systemd.services.nwc-lnurl = {
-    description = "Lightning Wallet Connections public LNURL service";
-    wantedBy = [ "multi-user.target" ];
-    after = [ "albyhub.service" "sovran-hub-web.service" ];
-    wants = [ "albyhub.service" ];
-    environment = pythonManagerEnvironment;
-
-    serviceConfig = {
-      Type = "simple";
-      User = "albyhub";
-      Group = "albyhub";
-      ExecStart = "${config.services.sovranHub.webPackage}/bin/nwc-lnurl";
-      Restart = "on-failure";
-      RestartSec = "10s";
-      UMask = "0027";
-      NoNewPrivileges = true;
-      PrivateTmp = true;
-      ProtectHome = true;
-      ProtectSystem = "strict";
-      ReadOnlyPaths = [
-        "/var/lib/domains/lightning"
-        "/var/lib/albyhub/unlock-password"
-      ];
-    };
-  };
-
-  systemd.services.sovran-hub-web.environment = pythonManagerEnvironment;
-  environment.systemPackages = lib.mkBefore [ wrappedNwcWallet ];
-
-  sovran_systemsOS.domainRequirements = [
-    {
-      name = "lightning";
-      label = "Lightning Address Domain";
-      example = "pay.yourdomain.com";
-      needsDDNS = true;
-    }
-  ];
-}

modules/rdp.nix

@@ -2,104 +2,70 @@
 
 lib.mkIf config.sovran_systemsOS.features.rdp {
 
+  users.users.gnome-remote-desktop = {
+    isSystemUser = true;
+    group = "gnome-remote-desktop";
+    home = "/var/lib/gnome-remote-desktop";
+    createHome = true;
+  };
+  users.groups.gnome-remote-desktop = {};
+
   # Enable the GNOME Remote Desktop service at the system level
   services.gnome.gnome-remote-desktop.enable = true;
 
   # Open RDP port in the firewall
   networking.firewall.allowedTCPPorts = [ 3389 ];
 
-  # Ensure the service only starts after setup succeeds
+  # Ensure the service actually starts and waits for setup to complete
   systemd.services.gnome-remote-desktop = {
     wantedBy = [ "graphical.target" ];
     after = [ "gnome-remote-desktop-setup.service" ];
-    requires = [ "gnome-remote-desktop-setup.service" ];
+    wants = [ "gnome-remote-desktop-setup.service" ];
   };
 
   systemd.tmpfiles.rules = [
-    "d /var/lib/gnome-remote-desktop/.local 0700 gnome-remote-desktop gnome-remote-desktop -"
-    "d /var/lib/gnome-remote-desktop/.local/share 0700 gnome-remote-desktop gnome-remote-desktop -"
-    "d /var/lib/gnome-remote-desktop/.local/share/gnome-remote-desktop 0700 gnome-remote-desktop gnome-remote-desktop -"
-    "d /var/lib/gnome-remote-desktop/tls 0700 gnome-remote-desktop gnome-remote-desktop -"
+    "d /var/lib/gnome-remote-desktop 0750 gnome-remote-desktop gnome-remote-desktop -"
+    "d /var/lib/gnome-remote-desktop/.local 0750 gnome-remote-desktop gnome-remote-desktop -"
+    "d /var/lib/gnome-remote-desktop/.local/share 0750 gnome-remote-desktop gnome-remote-desktop -"
+    "d /var/lib/gnome-remote-desktop/.local/share/gnome-remote-desktop 0750 gnome-remote-desktop gnome-remote-desktop -"
   ];
 
   systemd.services.gnome-remote-desktop-setup = {
     description = "Configure GNOME Remote Desktop RDP";
-    wantedBy = [ "graphical.target" ];
+    wantedBy = [ "multi-user.target" ];
     before = [ "gnome-remote-desktop.service" ];
-    after = [
-      "dbus.service"
-      "systemd-tmpfiles-setup.service"
-      "network-online.target"
-      "gnome-remote-desktop-configuration.service"
-    ];
-    wants = [
-      "network-online.target"
-      "gnome-remote-desktop-configuration.service"
-    ];
+    after = [ "systemd-tmpfiles-setup.service" "network-online.target" ];
+    wants = [ "network-online.target" ];
     serviceConfig = {
       Type = "oneshot";
-      TimeoutStartSec = "2min";
+      RemainAfterExit = true;
     };
     path = [
-      pkgs.coreutils
-      pkgs.gawk
       pkgs.gnome-remote-desktop
-      pkgs.hostname
+      pkgs.polkit
       pkgs.openssl
-      pkgs.systemd
+      pkgs.hostname
+      pkgs.gawk
     ];
     script = ''
-      set -euo pipefail
+      # Ensure directory structure exists
+      mkdir -p /var/lib/gnome-remote-desktop/.local/share/gnome-remote-desktop
+      chown -R gnome-remote-desktop:gnome-remote-desktop /var/lib/gnome-remote-desktop
 
-      # GRD 50.x invokes pkexec internally for every grdctl --system call, even
-      # when the caller is root.  NixOS exposes the required setuid wrapper at
-      # /run/wrappers/bin/pkexec; the Nix-store polkit binary is not setuid and
-      # must not shadow it.  Prepend the wrapper directory so every subsequent
-      # grdctl --system resolves the correct binary.
-      export PATH="/run/wrappers/bin:$PATH"
-
-      STATE_DIR="/var/lib/gnome-remote-desktop"
-      TLS_DIR="$STATE_DIR/tls"
-      USERNAME_FILE="$STATE_DIR/rdp-username"
-      PASSWORD_FILE="$STATE_DIR/rdp-password"
-      CRED_FILE="$STATE_DIR/rdp-credentials"
-      DEFAULT_USERNAME="sovran"
-
-      grdctl_system() {
-        local rc=0
-
-        if timeout --kill-after=5s 10s \
-          grdctl --system "$@"; then
-          return 0
-        else
-          rc=$?
-        fi
-
-        if [ "$rc" -eq 124 ] || [ "$rc" -eq 137 ]; then
-          echo "grdctl command timed out: $*" >&2
-        fi
-        echo "grdctl command failed (exit $rc): $*" >&2
-
-        return "$rc"
-      }
-
-      mkdir -p "$STATE_DIR/.local/share/gnome-remote-desktop" "$TLS_DIR"
-      chown -R gnome-remote-desktop:gnome-remote-desktop "$STATE_DIR"
-      chmod 700 \
-        "$STATE_DIR" \
-        "$STATE_DIR/.local" \
-        "$STATE_DIR/.local/share" \
-        "$STATE_DIR/.local/share/gnome-remote-desktop" \
-        "$TLS_DIR"
+      TLS_DIR="/var/lib/gnome-remote-desktop/tls"
+      CRED_FILE="/var/lib/gnome-remote-desktop/rdp-credentials"
 
+      # Regenerate TLS certificate if missing OR if ownership is wrong
+      # (disable/re-enable cycle can break ownership or grdctl state)
       NEED_REGEN=0
       if [ ! -f "$TLS_DIR/rdp-tls.crt" ] || [ ! -f "$TLS_DIR/rdp-tls.key" ]; then
         NEED_REGEN=1
-      elif [ "$(stat -c '%U:%G' "$TLS_DIR/rdp-tls.key" 2>/dev/null)" != "gnome-remote-desktop:gnome-remote-desktop" ]; then
+      elif [ "$(stat -c '%U' "$TLS_DIR/rdp-tls.key" 2>/dev/null)" != "gnome-remote-desktop" ]; then
         NEED_REGEN=1
       fi
 
       if [ "$NEED_REGEN" = "1" ]; then
+        mkdir -p "$TLS_DIR"
         rm -f "$TLS_DIR/rdp-tls.key" "$TLS_DIR/rdp-tls.crt"
         openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 \
           -sha256 -nodes -days 3650 \
@@ -109,59 +75,39 @@ lib.mkIf config.sovran_systemsOS.features.rdp {
         echo "Generated new RDP TLS certificate"
       fi
 
-      chown gnome-remote-desktop:gnome-remote-desktop "$TLS_DIR/rdp-tls.key" "$TLS_DIR/rdp-tls.crt"
+      # Always fix ownership and permissions (handles re-enable after disable)
+      chown -R gnome-remote-desktop:gnome-remote-desktop "$TLS_DIR"
       chmod 600 "$TLS_DIR/rdp-tls.key"
       chmod 644 "$TLS_DIR/rdp-tls.crt"
 
-      if [ ! -f "$USERNAME_FILE" ]; then
-        printf '%s\n' "$DEFAULT_USERNAME" > "$USERNAME_FILE"
-      fi
-      USERNAME="$(tr -d '\n' < "$USERNAME_FILE")"
-      if [ -z "$USERNAME" ]; then
-        USERNAME="$DEFAULT_USERNAME"
-        printf '%s\n' "$USERNAME" > "$USERNAME_FILE"
-      fi
-      if [ "''${#USERNAME}" -gt 32 ]; then
-        echo "RDP username is too long (''${#USERNAME} characters, maximum 32): $USERNAME from $USERNAME_FILE" >&2
-        exit 1
-      fi
-      case "$USERNAME" in
-        [A-Za-z_][A-Za-z0-9_-]*)
-          ;;
-        *)
-          echo "RDP username must start with a letter or underscore and contain only letters, numbers, underscores, and hyphens: $USERNAME from $USERNAME_FILE" >&2
-          exit 1
-          ;;
-      esac
-      chown gnome-remote-desktop:gnome-remote-desktop "$USERNAME_FILE"
-      chmod 600 "$USERNAME_FILE"
+      # Configure TLS certificate
+      grdctl --system rdp set-tls-cert "$TLS_DIR/rdp-tls.crt"
+      grdctl --system rdp set-tls-key "$TLS_DIR/rdp-tls.key"
 
-      if [ ! -f "$PASSWORD_FILE" ]; then
-        openssl rand -base64 16 > "$PASSWORD_FILE"
-      fi
-      PASSWORD="$(tr -d '\n' < "$PASSWORD_FILE")"
-      if [ -z "$PASSWORD" ]; then
-        echo "RDP password file is empty: $PASSWORD_FILE" >&2
-        exit 1
-      fi
-      if [ "''${#PASSWORD}" -lt 8 ]; then
-        echo "RDP password is too short (''${#PASSWORD} characters, minimum 8): $PASSWORD_FILE" >&2
-        exit 1
-      fi
-      chown gnome-remote-desktop:gnome-remote-desktop "$PASSWORD_FILE"
-      chmod 600 "$PASSWORD_FILE"
-
-      LOCAL_IP="$(hostname -I | awk '{print $1}')"
-      if [ -z "$LOCAL_IP" ]; then
-        LOCAL_IP="127.0.0.1"
+      # Generate password on first boot only
+      PASSWORD=""
+      if [ ! -f /var/lib/gnome-remote-desktop/rdp-password ]; then
+        PASSWORD=$(openssl rand -base64 16)
+        echo "$PASSWORD" > /var/lib/gnome-remote-desktop/rdp-password
+        chmod 600 /var/lib/gnome-remote-desktop/rdp-password
+      else
+        PASSWORD=$(cat /var/lib/gnome-remote-desktop/rdp-password)
       fi
 
+      # Write username to a separate file for the hub
+      echo "sovran" > /var/lib/gnome-remote-desktop/rdp-username
+      chmod 600 /var/lib/gnome-remote-desktop/rdp-username
+
+      # Get current IP address
+      LOCAL_IP=$(hostname -I | awk '{print $1}')
+
+      # Always rewrite the credentials file with the current IP
       cat > "$CRED_FILE" <<EOF
       ========================================
        GNOME Remote Desktop (RDP) Credentials
       ========================================
 
-       Username: $USERNAME
+       Username: sovran
        Password: $PASSWORD
 
        Connect from any RDP client to:
@@ -170,22 +116,11 @@ lib.mkIf config.sovran_systemsOS.features.rdp {
       ========================================
       EOF
 
-      chown gnome-remote-desktop:gnome-remote-desktop "$CRED_FILE"
       chmod 600 "$CRED_FILE"
 
-      # Preflight: the NixOS setuid pkexec wrapper must be present and executable
-      # before any grdctl --system call.  Absence means the system was booted
-      # without security.wrappers or the wrapper directory is not mounted yet.
-      if ! test -x /run/wrappers/bin/pkexec; then
-        echo "Preflight check failed: /run/wrappers/bin/pkexec is absent or not executable." >&2
-        echo "GNOME Remote Desktop system configuration requires the NixOS setuid pkexec wrapper at /run/wrappers/bin/pkexec." >&2
-        exit 1
-      fi
-
-      grdctl_system rdp enable
-      grdctl_system rdp set-tls-cert "$TLS_DIR/rdp-tls.crt"
-      grdctl_system rdp set-tls-key "$TLS_DIR/rdp-tls.key"
-      grdctl_system rdp set-credentials "$USERNAME" "$PASSWORD"
+      # Enable RDP backend and set credentials
+      grdctl --system rdp enable
+      grdctl --system rdp set-credentials sovran "$PASSWORD"
 
       echo "GNOME Remote Desktop RDP configured successfully"
     '';

modules/synapse.nix

@@ -229,30 +229,6 @@ CREDS
         chmod 600 "$CREDS_FILE"
       fi
 
-      # Provision a private, random Matrix administrator for the Hub's Admin
-      # API calls.  This is deliberately separate from the visible bootstrap
-      # admin account: installations where @admin pre-dated Sovran do not have
-      # its password, but Hub user management must still work.  Keeping the
-      # generated localpart in this root-only file makes the operation
-      # idempotent without exposing this service credential in the Hub UI.
-      HUB_ADMIN_CREDS="/var/lib/secrets/matrix-hub-admin"
-      if [ ! -s "$HUB_ADMIN_CREDS" ]; then
-        HUB_ADMIN_USER="sovran-hub-$(tr -dc 'a-z0-9' < /dev/urandom | head -c 20)"
-        HUB_ADMIN_PASS=$(pwgen -s 32 1)
-        if register_new_matrix_user -c /run/matrix-synapse/runtime-config.yaml \
-          -u "$HUB_ADMIN_USER" -p "$HUB_ADMIN_PASS" -a http://localhost:8008; then
-          (umask 077; cat > "$HUB_ADMIN_CREDS" <<CREDS
-username=$HUB_ADMIN_USER
-password=$HUB_ADMIN_PASS
-CREDS
-          )
-          echo "Created private Matrix Hub service administrator."
-        else
-          echo "Failed to create the private Matrix Hub service administrator." >&2
-          exit 1
-        fi
-      fi
-
       # Always write individual credential files for the hub UI, even if the bulk
       # credentials file already existed from a prior run (umask 077 ensures mode 600).
       # If passwords were not freshly generated above, parse them from the bulk file.

packages/albyhub/0001-private-route-hints.patch

@@ -1,13 +0,0 @@
-diff --git a/lnclient/lnd/lnd.go b/lnclient/lnd/lnd.go
-index bad532f..ba35b7b 100644
---- a/lnclient/lnd/lnd.go
-+++ b/lnclient/lnd/lnd.go
-@@ -708,7 +708,7 @@ func (svc *LNDService) MakeInvoice(ctx context.Context, amountMsat int64, descri
- 		DescriptionHash: descriptionHashBytes,
- 		Expiry:          expiry,
- 		RouteHints:      hints,
--		Private:         !hasPublicChannels, // use private channel hints in the invoice
-+		Private:         true, // always include private channel hints in the invoice
- 	}
- 
- 	resp, err := svc.client.AddInvoice(ctx, addInvoiceRequest)

packages/albyhub/0002-isolated-invoice-app-id.patch

@@ -1,71 +0,0 @@
-diff --git a/api/models.go b/api/models.go
-index 28bd117..dceb79a 100644
---- a/api/models.go
-+++ b/api/models.go
-@@ -46,7 +46,7 @@ type API interface {
- 	ListTransactions(ctx context.Context, appId *uint, limit uint64, offset uint64) (*ListTransactionsResponse, error)
- 	ListOnchainTransactions(ctx context.Context) ([]OnchainTransaction, error)
- 	SendPayment(ctx context.Context, invoice string, amountMsat *uint64, metadata map[string]interface{}, fromAppId *uint) (*SendPaymentResponse, error)
--	CreateInvoice(ctx context.Context, amountMsat uint64, description string) (*MakeInvoiceResponse, error)
-+	CreateInvoice(ctx context.Context, amountMsat uint64, description string, appId *uint) (*MakeInvoiceResponse, error)
- 	LookupInvoice(ctx context.Context, paymentHash string) (*LookupInvoiceResponse, error)
- 	SetTransactionUserLabels(ctx context.Context, id uint, labels map[string]string) error
- 	RequestMempoolApi(ctx context.Context, endpoint string) (interface{}, error)
-@@ -586,6 +586,7 @@ type MakeInvoiceRequest struct {
- 	AmountSat   *uint64 `json:"amountSat"`
- 	AmountMsat  *uint64 `json:"amountMsat"`
- 	Description string  `json:"description"`
-+	AppId       *uint   `json:"appId"`
- }
- 
- type ResetRouterRequest struct {
-diff --git a/api/transactions.go b/api/transactions.go
-index aaf9380..3f9850a 100644
---- a/api/transactions.go
-+++ b/api/transactions.go
-@@ -12,12 +12,12 @@ import (
- 	"github.com/sirupsen/logrus"
- )
- 
--func (api *api) CreateInvoice(ctx context.Context, amountMsat uint64, description string) (*MakeInvoiceResponse, error) {
-+func (api *api) CreateInvoice(ctx context.Context, amountMsat uint64, description string, appId *uint) (*MakeInvoiceResponse, error) {
- 	lnClient := api.svc.GetLNClient()
- 	if lnClient == nil {
- 		return nil, ErrLNClientNotStarted
- 	}
--	transaction, err := api.svc.GetTransactionsService().MakeInvoice(ctx, amountMsat, description, "", 0, nil, lnClient, nil, nil, nil)
-+	transaction, err := api.svc.GetTransactionsService().MakeInvoice(ctx, amountMsat, description, "", 0, nil, lnClient, appId, nil, nil)
- 	if err != nil {
- 		return nil, err
- 	}
-diff --git a/http/http_service.go b/http/http_service.go
-index bf650b9..cf61250 100644
---- a/http/http_service.go
-+++ b/http/http_service.go
-@@ -687,7 +687,12 @@ func (httpSvc *HttpService) makeInvoiceHandler(c echo.Context) error {
- 		amountMsat = *resolvedAmountMsat
- 	}
- 
--	invoice, err := httpSvc.api.CreateInvoice(c.Request().Context(), amountMsat, makeInvoiceRequest.Description)
-+	invoice, err := httpSvc.api.CreateInvoice(
-+		c.Request().Context(),
-+		amountMsat,
-+		makeInvoiceRequest.Description,
-+		makeInvoiceRequest.AppId,
-+	)
- 
- 	if err != nil {
- 		return c.JSON(http.StatusInternalServerError, ErrorResponse{
-diff --git a/wails/wails_handlers.go b/wails/wails_handlers.go
-index d25259b..c9fe4e8 100644
---- a/wails/wails_handlers.go
-+++ b/wails/wails_handlers.go
-@@ -600,7 +600,7 @@ func (app *WailsApp) WailsRequestRouter(route string, method string, body string
- 		if resolvedAmountMsat != nil {
- 			amountMsat = *resolvedAmountMsat
- 		}
--		invoice, err := app.api.CreateInvoice(ctx, amountMsat, makeInvoiceRequest.Description)
-+		invoice, err := app.api.CreateInvoice(ctx, amountMsat, makeInvoiceRequest.Description, nil)
- 		if err != nil {
- 			return WailsRequestRouterResponse{Body: nil, Error: err.Error()}
- 		}

packages/albyhub/0003-loopback-bind-host.patch

@@ -1,37 +0,0 @@
-diff --git a/cmd/http/main.go b/cmd/http/main.go
-index ed31f96..4d31212 100644
---- a/cmd/http/main.go
-+++ b/cmd/http/main.go
-@@ -2,8 +2,8 @@ package main
- 
- import (
- 	"context"
--	"fmt"
- 	nethttp "net/http"
-+	"net"
- 	"os"
- 	"os/signal"
- 	"syscall"
-@@ -51,8 +51,9 @@ func main() {
- 	httpSvc := http.NewHttpService(svc, svc.GetEventPublisher())
- 	httpSvc.RegisterSharedRoutes(e)
- 	//start Echo server
-+	bindAddress := net.JoinHostPort(svc.GetConfig().GetEnv().Host, svc.GetConfig().GetEnv().Port)
- 	go func() {
--		if err := e.Start(fmt.Sprintf(":%v", svc.GetConfig().GetEnv().Port)); err != nil && err != nethttp.ErrServerClosed {
-+		if err := e.Start(bindAddress); err != nil && err != nethttp.ErrServerClosed {
- 			logger.Logger.WithError(err).Error("echo server failed to start")
- 			cancel()
- 		}
-diff --git a/config/models.go b/config/models.go
-index 0fb8870..dc11afd 100644
---- a/config/models.go
-+++ b/config/models.go
-@@ -24,6 +24,7 @@ type AppConfig struct {
- 	LNDAddress                         string `envconfig:"LND_ADDRESS"`
- 	LNDCertFile                        string `envconfig:"LND_CERT_FILE"`
- 	LNDMacaroonFile                    string `envconfig:"LND_MACAROON_FILE"`
-+	Host                               string `envconfig:"HOST" default:"127.0.0.1"`
- 	Workdir                            string `envconfig:"WORK_DIR"`
- 	Port                               string `envconfig:"PORT" default:"8080"`
- 	DatabaseUri                        string `envconfig:"DATABASE_URI" default:"nwc.db"`

scripts/release-stable.sh

@@ -1,479 +0,0 @@
-#!/usr/bin/env bash
-#
-# release-stable.sh
-# Automated stable release script for Sovran_SystemsOS
-#
-# Features:
-# - Detects latest tag and suggests next version
-# - Pushes main → stable on Gitea
-# - Creates annotated tag
-# - Auto-updates CHANGELOG.md
-# - Creates releases on both GitHub and Gitea via API
-#
-# Usage:
-#   ./scripts/release-stable.sh [version] [--message "text"]
-#
-# Requirements:
-#   - gh CLI (for GitHub releases)
-#   - GITEA_TOKEN env var (for Gitea releases)
-#
-
-set -euo pipefail
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-# Configuration
-GITEA_REMOTE_DEFAULT="gitea"
-GITHUB_REMOTE_DEFAULT="origin"
-GITEA_API_URL="https://git.sovransystems.com/api/v1"
-CHANGELOG_FILE="CHANGELOG.md"
-
-# Auto-detect remotes
-detect_remote() {
-    local preferred="$1"
-    local keyword="$2"
-    if git remote | grep -q -x "$preferred"; then
-        echo "$preferred"
-        return
-    fi
-    local found
-    found=$(git remote -v | grep -i "$keyword" | head -n 1 | awk '{print $1}')
-    if [[ -n "$found" ]]; then
-        echo "$found"
-        return
-    fi
-    echo "$preferred"
-}
-
-GITEA_REMOTE=$(detect_remote "$GITEA_REMOTE_DEFAULT" "sovransystems\|gitea")
-GITHUB_REMOTE=$(detect_remote "$GITHUB_REMOTE_DEFAULT" "github")
-
-echo -e "${BLUE}╔════════════════════════════════════════════════════════════╗${NC}"
-echo -e "${BLUE}║     Sovran_SystemsOS Automated Stable Release Script       ║${NC}"
-echo -e "${BLUE}╚════════════════════════════════════════════════════════════╝${NC}"
-echo
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Helper: Get latest tag
-# ─────────────────────────────────────────────────────────────────────────────
-get_latest_tag() {
-    local exclude="${1:-}"
-    if [[ -n "$exclude" ]]; then
-        git tag --list 'v*' --sort=-version:refname | grep -v -x -E "v?${exclude#v}|${exclude}" | head -1 || echo ""
-    else
-        git tag --list 'v*' --sort=-version:refname | head -1 || echo ""
-    fi
-}
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Helper: Suggest next version (patch bump)
-# ─────────────────────────────────────────────────────────────────────────────
-suggest_next_version() {
-    local current="$1"
-    if [[ -z "$current" ]]; then
-        echo "1.0.0"
-        return
-    fi
-
-    # Remove 'v' prefix
-    local ver="${current#v}"
-    IFS='.' read -r major minor patch <<< "$ver"
-
-    # Default: bump patch
-    echo "${major}.$((minor)).$((patch + 1))"
-}
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Step 0: Fetch everything
-# ─────────────────────────────────────────────────────────────────────────────
-echo -e "${BLUE}Step 0: Fetching latest from all remotes...${NC}"
-git fetch --all --tags 2>/dev/null || true
-
-LATEST_TAG=$(get_latest_tag)
-NEXT_VERSION=$(suggest_next_version "$LATEST_TAG")
-
-echo -e "  Latest tag   : ${CYAN}${LATEST_TAG:-none}${NC}"
-echo -e "  Suggested    : ${GREEN}v${NEXT_VERSION}${NC}"
-echo
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Get version from user or argument
-# ─────────────────────────────────────────────────────────────────────────────
-if [ $# -ge 1 ] && [[ "$1" != --* ]]; then
-    VERSION="$1"
-    shift
-else
-    read -rp "Enter version to release (default: ${NEXT_VERSION}): " input_version
-    VERSION="${input_version:-$NEXT_VERSION}"
-fi
-
-# Strip 'v' if user added it
-VERSION="${VERSION#v}"
-TAG="v${VERSION}"
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Get release message
-# ─────────────────────────────────────────────────────────────────────────────
-RELEASE_MESSAGE=""
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --message|-m)
-            RELEASE_MESSAGE="$2"
-            shift 2
-            ;;
-        *)
-            shift
-            ;;
-    esac
-done
-
-if [[ -z "$RELEASE_MESSAGE" ]]; then
-    echo
-    read -rp "Enter release headline (or press Enter for default): " input_msg
-    if [[ -n "$input_msg" ]]; then
-        RELEASE_MESSAGE="$input_msg"
-    else
-        RELEASE_MESSAGE="Sovran_SystemsOS ${TAG} — Stable Release"
-    fi
-fi
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Helper: Generate categorized release notes from commit history
-# Groups commits since the last tag into Keep-a-Changelog sections based on
-# conventional-commit prefixes (feat/fix/docs/security/etc.) and keywords.
-# ─────────────────────────────────────────────────────────────────────────────
-generate_release_notes() {
-    local range="$1"
-
-    local added="" changed="" fixed="" security="" docs=""
-
-    while IFS= read -r subject; do
-        # Skip noise commits
-        case "$subject" in
-            "Initial plan"|"initial plan") continue ;;
-            "Merge pull request"*|"Merge branch"*) continue ;;
-            "chore: bump VERSION"*|"docs: update CHANGELOG"*) continue ;;
-            "Address code review"*|"Address review"*|"Address validation"*) continue ;;
-        esac
-
-        # Strip conventional-commit prefix for display
-        local clean
-        clean="$(echo "$subject" | sed -E 's/^(feat|fix|docs|chore|refactor|test|security|perf|style|ci|build)(\([^)]*\))?!?:[[:space:]]*//')"
-        # Capitalize first letter
-        clean="$(echo "${clean:0:1}" | tr '[:lower:]' '[:upper:]')${clean:1}"
-
-        case "$subject" in
-            security:*|security\(*)         security+="- ${clean}"$'\n' ;;
-            feat:*|feat\(*)                 added+="- ${clean}"$'\n' ;;
-            fix:*|fix\(*|Fix\ *|fixed\ *)   fixed+="- ${clean}"$'\n' ;;
-            docs:*|docs\(*)                 docs+="- ${clean}"$'\n' ;;
-            refactor:*|refactor\(*|chore:*|chore\(*|removed\ *|Updated\ *|updated\ *) changed+="- ${clean}"$'\n' ;;
-            test:*|test\(*)                 continue ;;
-            *)                              added+="- ${clean}"$'\n' ;;
-        esac
-    done < <(git log --no-merges --format='%s' "$range" 2>/dev/null | awk '!seen[$0]++')
-
-    local notes=""
-    if [[ -n "$added" ]];    then notes+=$'### Added\n'"$added"$'\n'; fi
-    if [[ -n "$changed" ]];  then notes+=$'### Changed\n'"$changed"$'\n'; fi
-    if [[ -n "$fixed" ]];    then notes+=$'### Fixed\n'"$fixed"$'\n'; fi
-    if [[ -n "$security" ]]; then notes+=$'### Security\n'"$security"$'\n'; fi
-    if [[ -n "$docs" ]];     then notes+=$'### Documentation\n'"$docs"$'\n'; fi
-
-    if [[ -z "$notes" ]]; then
-        notes=$'### Changed\n- Incremental stable updates\n'
-    fi
-
-    printf '%s' "$notes"
-}
-
-# Build the notes from commits since the previous tag (exclude the target tag if already present)
-PREV_TAG=$(get_latest_tag "$TAG")
-if [[ -n "$PREV_TAG" ]] && git rev-parse -q --verify "$PREV_TAG" >/dev/null; then
-    COMMIT_RANGE="${PREV_TAG}..HEAD"
-else
-    COMMIT_RANGE="HEAD"
-fi
-
-echo
-echo -e "${BLUE}Generating draft release notes from ${COMMIT_RANGE}...${NC}"
-RELEASE_NOTES="$(generate_release_notes "$COMMIT_RANGE")"
-
-# Let the user review/edit the generated notes before publishing
-NOTES_FILE="$(mktemp "/tmp/release-notes-${TAG}.XXXXXX.md")"
-{
-    echo "## Sovran_SystemsOS ${TAG}"
-    echo
-    echo "${RELEASE_MESSAGE}"
-    echo
-    echo "$RELEASE_NOTES"
-    echo "**Full changelog:** [CHANGELOG.md](https://github.com/naturallaw777/Sovran_SystemsOS/blob/main/CHANGELOG.md)"
-} > "$NOTES_FILE"
-
-echo -e "  ${GREEN}✓${NC} Draft notes written to: ${CYAN}${NOTES_FILE}${NC}"
-echo
-echo "──────────────── Draft Release Notes ────────────────"
-cat "$NOTES_FILE"
-echo "──────────────────────────────────────────────────────"
-echo
-read -rp "Edit the notes before publishing? (y/N): " edit_confirm
-if [[ "$edit_confirm" =~ ^[Yy]$ ]]; then
-    "${EDITOR:-nano}" "$NOTES_FILE"
-    RELEASE_NOTES="$(sed -n '/^###/,$p' "$NOTES_FILE" | sed '/^\*\*Full changelog/d')"
-fi
-RELEASE_BODY="$(cat "$NOTES_FILE")"
-
-echo
-echo -e "${YELLOW}════════════════════════════════════════════════════════════${NC}"
-echo -e "${YELLOW}  Preparing Release${NC}"
-echo -e "${YELLOW}════════════════════════════════════════════════════════════${NC}"
-echo "  Version       : ${TAG}"
-echo "  Message       : ${RELEASE_MESSAGE}"
-echo "  Gitea Remote  : ${GITEA_REMOTE}"
-echo "  GitHub Remote : ${GITHUB_REMOTE}"
-echo
-
-read -rp "Proceed with this release? (y/N): " confirm
-if [[ ! "$confirm" =~ ^[Yy]$ ]]; then
-    echo "Aborted."
-    exit 0
-fi
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Step 1: Push tested code to Gitea (stable & staging-dev)
-# ─────────────────────────────────────────────────────────────────────────────
-echo
-echo -e "${BLUE}Step 1: Pushing tested code to Gitea (stable & staging-dev)...${NC}"
-if git remote | grep -q -x "${GITEA_REMOTE}"; then
-    git push "${GITEA_REMOTE}" HEAD:stable --force-with-lease || echo -e "  ${YELLOW}⚠ Push to ${GITEA_REMOTE} (stable) failed.${NC}"
-    git push "${GITEA_REMOTE}" HEAD:staging-dev --force-with-lease || echo -e "  ${YELLOW}⚠ Push to ${GITEA_REMOTE} (staging-dev) failed.${NC}"
-else
-    echo -e "  ${YELLOW}⚠ Remote '${GITEA_REMOTE}' not found in git — skipping Gitea push.${NC}"
-fi
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Step 2: Create annotated tag
-# ─────────────────────────────────────────────────────────────────────────────
-echo
-echo -e "${BLUE}Step 2: Creating annotated tag ${TAG}...${NC}"
-git tag -f -a "${TAG}" -m "${RELEASE_MESSAGE}
-
-- Stable release of Sovran_SystemsOS
-- See CHANGELOG.md for full details" || true
-
-if git remote | grep -q -x "${GITEA_REMOTE}"; then
-    git push "${GITEA_REMOTE}" "${TAG}" || echo -e "  ${YELLOW}⚠ Tag push to ${GITEA_REMOTE} failed.${NC}"
-else
-    echo -e "  ${YELLOW}⚠ Remote '${GITEA_REMOTE}' not found in git — skipping Gitea tag push.${NC}"
-fi
-
-if git remote | grep -q -x "${GITHUB_REMOTE}"; then
-    git push "${GITHUB_REMOTE}" "${TAG}" || echo -e "  ${YELLOW}⚠ Tag push to ${GITHUB_REMOTE} failed.${NC}"
-fi
-
-# Update VERSION file for ISO builds
-echo "${VERSION}" > VERSION
-git add VERSION
-git commit -m "chore: bump VERSION to ${TAG} for ISO naming" || true
-echo -e "  ${GREEN}✓${NC} VERSION file updated to ${VERSION}"
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Step 2b: Auto-update README.md ISO download references
-# ─────────────────────────────────────────────────────────────────────────────
-echo
-echo -e "${BLUE}Step 2b: Updating README.md ISO references to ${VERSION}...${NC}"
-
-README_FILE="README.md"
-if [ -f "$README_FILE" ]; then
-    # Extract the version currently used in the README's ISO filenames,
-    # e.g. "Sovran_SystemsOS-1.0.6.iso" -> "1.0.6"
-    OLD_ISO_VER=$(grep -oE 'Sovran_SystemsOS-[0-9]+\.[0-9]+\.[0-9]+\.iso' "$README_FILE" | head -1 | sed 's/Sovran_SystemsOS-//; s/\.iso//')
-
-    if [ -n "$OLD_ISO_VER" ] && [ "$OLD_ISO_VER" != "$VERSION" ]; then
-        # Portable in-place edit (works with GNU sed and BSD/macOS sed)
-        sed "s/Sovran_SystemsOS-${OLD_ISO_VER}/Sovran_SystemsOS-${VERSION}/g" \
-            "$README_FILE" > "$README_FILE.tmp" && mv "$README_FILE.tmp" "$README_FILE"
-
-        UPDATED=$(grep -c "Sovran_SystemsOS-${VERSION}" "$README_FILE")
-        echo -e "  ${GREEN}✓${NC} README.md: ${OLD_ISO_VER} -> ${VERSION} (${UPDATED} references updated)"
-
-        git add "$README_FILE"
-        git commit -m "docs: update README ISO download links to ${TAG}" || true
-        echo -e "  ${GREEN}✓${NC} Committed README update"
-    else
-        echo -e "  ${YELLOW}⚠${NC} README.md already references ${VERSION} or no versioned ISO links found — skipping"
-    fi
-else
-    echo -e "  ${YELLOW}⚠${NC} README.md not found — skipping"
-fi
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Step 3: Auto-update CHANGELOG.md
-# ─────────────────────────────────────────────────────────────────────────────
-echo
-echo -e "${BLUE}Step 3: Updating ${CHANGELOG_FILE}...${NC}"
-
-TODAY=$(date +%Y-%m-%d)
-
-# Create new changelog entry from the generated notes (no placeholders)
-NEW_ENTRY="## [${VERSION}] - ${TODAY}
-
-${RELEASE_NOTES}
-[${VERSION}]: https://git.sovransystems.com/Sovran_Systems/Sovran_SystemsOS/releases/tag/${TAG}
-"
-
-# Prepend to changelog (after the header)
-if [ -f "$CHANGELOG_FILE" ]; then
-    # Backup
-    cp "$CHANGELOG_FILE" "${CHANGELOG_FILE}.bak"
-
-    # Insert new section after the first --- line
-    awk -v new_entry="$NEW_ENTRY" '
-        BEGIN { printed=0 }
-        /^---$/ && !printed {
-            print
-            print ""
-            print new_entry
-            printed=1
-            next
-        }
-        { print }
-    ' "$CHANGELOG_FILE" > "${CHANGELOG_FILE}.tmp" && mv "${CHANGELOG_FILE}.tmp" "$CHANGELOG_FILE"
-    rm -f "${CHANGELOG_FILE}.bak"
-
-    echo -e "  ${GREEN}✓${NC} CHANGELOG.md updated with new section for ${TAG}"
-else
-    echo -e "  ${YELLOW}⚠${NC} CHANGELOG.md not found — skipping"
-fi
-
-# Commit the changelog update
-git add "$CHANGELOG_FILE"
-if git diff --cached --quiet; then
-    echo "  (No changes to commit in changelog)"
-else
-    git commit -m "docs: update CHANGELOG.md for ${TAG}"
-    echo -e "  ${GREEN}✓${NC} Committed changelog update"
-
-    # Ask if user wants to push
-    echo
-    read -rp "Push the changelog commit to GitHub (main) and Gitea (staging-dev) now? (y/N): " push_confirm
-    if [[ "$push_confirm" =~ ^[Yy]$ ]]; then
-        if git remote | grep -q -x "${GITHUB_REMOTE}"; then
-            echo -e "${BLUE}Pushing changelog commit to GitHub main...${NC}"
-            if git push "${GITHUB_REMOTE}" HEAD:main; then
-                echo -e "  ${GREEN}✓${NC} Changelog pushed to GitHub main (${GITHUB_REMOTE})"
-            else
-                echo -e "  ${YELLOW}⚠ Push to GitHub main failed — verify credentials or remote name.${NC}"
-            fi
-        fi
-        if git remote | grep -q -x "${GITEA_REMOTE}"; then
-            echo -e "${BLUE}Pushing changelog commit to Gitea staging-dev...${NC}"
-            if git push "${GITEA_REMOTE}" HEAD:staging-dev; then
-                echo -e "  ${GREEN}✓${NC} Changelog pushed to Gitea staging-dev (${GITEA_REMOTE})"
-            else
-                echo -e "  ${YELLOW}⚠ Push to Gitea staging-dev failed.${NC}"
-            fi
-        fi
-    else
-        echo "  (Changelog commit left local — remember to push later)"
-    fi
-fi
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Step 4: Create GitHub Release via gh CLI
-# ─────────────────────────────────────────────────────────────────────────────
-echo
-echo -e "${BLUE}Step 4: Creating GitHub Release...${NC}"
-
-if command -v gh &>/dev/null; then
-    title_suffix="${RELEASE_MESSAGE#Sovran_SystemsOS v* — }"
-    title_suffix="${title_suffix#Sovran_SystemsOS * — }"
-    if gh release create "${TAG}" \
-        --repo naturallaw777/Sovran_SystemsOS \
-        --title "${TAG} — ${title_suffix}" \
-        --notes-file "${NOTES_FILE}"; then
-        echo -e "  ${GREEN}✓${NC} GitHub release created successfully"
-    else
-        echo -e "  ${YELLOW}⚠${NC} GitHub release creation failed (check 'gh auth status' or create via web GUI)"
-    fi
-else
-    echo -e "  ${YELLOW}⚠${NC} gh CLI not found — skipping GitHub release (create via GitHub web GUI)"
-fi
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Step 5: Create Gitea Release via API
-# ─────────────────────────────────────────────────────────────────────────────
-echo
-echo -e "${BLUE}Step 5: Creating Gitea Release via API...${NC}"
-
-# ── Gitea Token Handling ─────────────────────────────────────────────────────
-if [[ -z "${GITEA_TOKEN:-}" ]]; then
-    echo
-    echo -e "${YELLOW}GITEA_TOKEN is not set.${NC}"
-    read -rsp "Enter your Gitea API token (input will be hidden): " GITEA_TOKEN
-    echo
-    if [[ -z "$GITEA_TOKEN" ]]; then
-        echo -e "  ${YELLOW}⚠${NC} No token provided — skipping Gitea release"
-        GITEA_TOKEN=""
-    fi
-fi
-
-if [[ -n "${GITEA_TOKEN:-}" ]]; then
-    GITEA_REPO="Sovran_Systems/Sovran_SystemsOS"
-
-    # Build JSON payload safely (release body may contain quotes/newlines)
-    if command -v jq &>/dev/null; then
-        PAYLOAD=$(jq -n \
-            --arg tag "${TAG}" \
-            --arg name "${TAG} — Stable Release" \
-            --arg body "${RELEASE_BODY}" \
-            '{tag_name: $tag, name: $name, body: $body, draft: false, prerelease: false}')
-    else
-        PAYLOAD=$(python3 -c "import json,sys; print(json.dumps({'tag_name': sys.argv[1], 'name': sys.argv[1] + ' — Stable Release', 'body': open(sys.argv[2]).read(), 'draft': False, 'prerelease': False}))" "${TAG}" "${NOTES_FILE}")
-    fi
-
-    RESPONSE=$(curl -s -X POST \
-        -H "Authorization: token ${GITEA_TOKEN}" \
-        -H "Content-Type: application/json" \
-        -d "${PAYLOAD}" \
-        "${GITEA_API_URL}/repos/${GITEA_REPO}/releases" 2>/dev/null || echo "")
-
-    if echo "$RESPONSE" | grep -q '"id"'; then
-        echo -e "  ${GREEN}✓${NC} Gitea release created successfully"
-    elif echo "$RESPONSE" | grep -q "write:repository"; then
-        echo -e "  ${YELLOW}⚠${NC} Gitea token scope issue: your token requires the 'write:repository' scope (currently has write:package)."
-        echo "     To fix: In Gitea, navigate to Settings → Applications → Manage Access Tokens and generate a token with 'write:repository'."
-    else
-        echo -e "  ${YELLOW}⚠${NC} Gitea release creation failed or already exists"
-        echo "     Response: $RESPONSE"
-    fi
-fi
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Final Summary
-# ─────────────────────────────────────────────────────────────────────────────
-echo
-echo -e "${GREEN}╔════════════════════════════════════════════════════════════╗${NC}"
-echo -e "${GREEN}║           ✅ Release ${TAG} completed successfully!          ║${NC}"
-echo -e "${GREEN}╚════════════════════════════════════════════════════════════╝${NC}"
-echo
-echo "Next manual steps (recommended):"
-echo "  • Build the installer ISO:"
-echo "    nix build .#nixosConfigurations.sovran_systemsos-iso.config.system.build.isoImage"
-echo "  • Package, verify, and upload ISO to CDN:"
-echo "    ./scripts/upload-cdn.sh --upload"
-echo "  • Review and enhance the new section in CHANGELOG.md"
-echo "  • Push changes: git push ${GITHUB_REMOTE} HEAD:main && git push ${GITEA_REMOTE} HEAD:staging-dev"
-echo "  • Verify releases on both GitHub and Gitea"
-echo
-echo -e "${CYAN}Tag created: ${TAG}${NC}"
-git show "${TAG}" --quiet
-
-# Clean up temp notes file
-rm -f "${NOTES_FILE}"

scripts/upload-cdn.sh

@@ -1,168 +0,0 @@
-#!/usr/bin/env bash
-#
-# upload-cdn.sh
-# Copies built ISO out of the nix store, generates versioned SHA-256 checksum,
-# verifies it, and optionally uploads to CDN.
-#
-# Usage:
-#   ./scripts/upload-cdn.sh [--upload]
-#
-# EVERYTHING this script creates lives OUTSIDE the repository, even when you
-# run it from inside the repo:
-#   - the nix build output symlink  -> $ISO_OUT_DIR/result
-#   - the ISO and .sha256 files     -> $ISO_OUT_DIR
-# The repo working tree stays completely clean.
-#
-# Environment variables (optional):
-#   ISO_OUT_DIR        - dir for the build symlink + ISO + checksum
-#                        (default: ~/Sovran-builds)
-#   CDN_RSYNC_TARGET   - rsync destination (e.g. user@server:/var/www/downloads/)
-#   CDN_RCLONE_REMOTE  - rclone remote target (e.g. s3:my-bucket/downloads/)
-#   CDN_UPLOAD_CMD     - custom upload command
-#
-
-set -euo pipefail
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-# Always operate from the repo root, no matter where the script is invoked from
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-cd "$REPO_ROOT"
-
-# Read version from VERSION file
-if [ ! -f VERSION ]; then
-    echo -e "${RED}Error: VERSION file not found in $REPO_ROOT.${NC}" >&2
-    exit 1
-fi
-VERSION=$(cat VERSION | tr -d '\n\r ')
-ISO_NAME="Sovran_SystemsOS-${VERSION}.iso"
-SHA_NAME="${ISO_NAME}.sha256"
-
-# Output directory OUTSIDE the repo (override with ISO_OUT_DIR)
-OUT_DIR="${ISO_OUT_DIR:-$HOME/Sovran-builds}"
-mkdir -p "$OUT_DIR"
-OUT_DIR="$(cd "$OUT_DIR" && pwd)"
-ISO_PATH="$OUT_DIR/${ISO_NAME}"
-SHA_PATH="$OUT_DIR/${SHA_NAME}"
-RESULT_LINK="$OUT_DIR/result"
-
-echo -e "${BLUE}╔════════════════════════════════════════════════════════════╗${NC}"
-echo -e "${BLUE}║      Sovran_SystemsOS CDN ISO Packaging & Upload Tool      ║${NC}"
-echo -e "${BLUE}╚════════════════════════════════════════════════════════════╝${NC}"
-echo -e "  Version : ${CYAN}${VERSION}${NC}"
-echo -e "  ISO     : ${CYAN}${ISO_NAME}${NC}"
-echo -e "  Repo    : ${CYAN}${REPO_ROOT}${NC}   (left untouched)"
-echo -e "  Output  : ${CYAN}${OUT_DIR}${NC}   (outside the repo)"
-echo
-
-# Locate or build ISO
-SRC_ISO=""
-if [ -f "$RESULT_LINK/iso/${ISO_NAME}" ]; then
-    SRC_ISO="$RESULT_LINK/iso/${ISO_NAME}"
-elif [ -f "$RESULT_LINK/iso/Sovran_SystemsOS.iso" ]; then
-    SRC_ISO="$RESULT_LINK/iso/Sovran_SystemsOS.iso"
-elif [ -f "result/iso/${ISO_NAME}" ]; then
-    SRC_ISO="result/iso/${ISO_NAME}"   # legacy: from an older in-repo build
-elif [ -f "result/iso/Sovran_SystemsOS.iso" ]; then
-    SRC_ISO="result/iso/Sovran_SystemsOS.iso"
-else
-    FOUND=$(find "$RESULT_LINK" result -name "*.iso" 2>/dev/null | head -n 1 || true)
-    if [ -n "$FOUND" ]; then
-        SRC_ISO="$FOUND"
-    fi
-fi
-
-if [ -z "$SRC_ISO" ] || [ ! -f "$SRC_ISO" ]; then
-    echo -e "${YELLOW}Built ISO not found. Building via Nix (result link goes outside the repo)...${NC}"
-    rm -f "$RESULT_LINK"
-    nix build .#nixosConfigurations.sovran_systemsos-iso.config.system.build.isoImage \
-        --out-link "$RESULT_LINK"
-
-    if [ -f "$RESULT_LINK/iso/${ISO_NAME}" ]; then
-        SRC_ISO="$RESULT_LINK/iso/${ISO_NAME}"
-    else
-        FOUND=$(find "$RESULT_LINK" -name "*.iso" 2>/dev/null | head -n 1 || true)
-        if [ -n "$FOUND" ]; then
-            SRC_ISO="$FOUND"
-        fi
-    fi
-fi
-
-if [ -z "$SRC_ISO" ] || [ ! -f "$SRC_ISO" ]; then
-    echo -e "${RED}Error: Failed to locate built ISO.${NC}" >&2
-    exit 1
-fi
-
-echo -e "${BLUE}Step 1: Copying built ISO to output dir (outside repo)...${NC}"
-cp -v "$SRC_ISO" "$ISO_PATH"
-echo -e "  ${GREEN}✓${NC} Copied to $ISO_PATH"
-
-echo
-echo -e "${BLUE}Step 2: Generating versioned SHA-256 checksum...${NC}"
-sha256sum "$ISO_PATH" > "$SHA_PATH"
-echo -e "  ${GREEN}✓${NC} Generated $SHA_PATH"
-cat "$SHA_PATH"
-
-echo
-echo -e "${BLUE}Step 3: Verifying checksum...${NC}"
-sha256sum --check "$SHA_PATH"
-echo -e "  ${GREEN}✓${NC} Checksum verified successfully"
-
-# Parse arguments for upload
-DO_UPLOAD=0
-for arg in "$@"; do
-    case $arg in
-        --upload)
-            DO_UPLOAD=1
-            shift
-            ;;
-    esac
-done
-
-if [ "$DO_UPLOAD" -eq 1 ]; then
-    echo
-    echo -e "${BLUE}Step 4: Uploading to CDN...${NC}"
-
-    UPLOADED=0
-    if [ -n "${CDN_UPLOAD_CMD:-}" ]; then
-        echo -e "  Running custom CDN_UPLOAD_CMD..."
-        eval "$CDN_UPLOAD_CMD"
-        UPLOADED=1
-    fi
-
-    if [ -n "${CDN_RSYNC_TARGET:-}" ]; then
-        echo -e "  Uploading via rsync to ${CDN_RSYNC_TARGET}..."
-        rsync -avP "$ISO_PATH" "$SHA_PATH" "${CDN_RSYNC_TARGET}"
-        UPLOADED=1
-    fi
-
-    if [ -n "${CDN_RCLONE_REMOTE:-}" ]; then
-        echo -e "  Uploading via rclone to ${CDN_RCLONE_REMOTE}..."
-        rclone copy "$ISO_PATH" "$SHA_PATH" "${CDN_RCLONE_REMOTE}"
-        UPLOADED=1
-    fi
-
-    if [ "$UPLOADED" -eq 0 ]; then
-        echo -e "  ${YELLOW}⚠ Warning: --upload requested, but no upload method specified.${NC}"
-        echo -e "     Set CDN_RSYNC_TARGET, CDN_RCLONE_REMOTE, or CDN_UPLOAD_CMD."
-    else
-        echo -e "  ${GREEN}✓${NC} Upload complete."
-    fi
-else
-    echo
-    echo -e "${GREEN}╔════════════════════════════════════════════════════════════╗${NC}"
-    echo -e "${GREEN}║           ✅ ISO packaging & verification complete!        ║${NC}"
-    echo -e "${GREEN}╚════════════════════════════════════════════════════════════╝${NC}"
-    echo -e "Ready files (in ${CYAN}${OUT_DIR}${NC}, outside the repo):"
-    ls -lh "$ISO_PATH" "$SHA_PATH"
-    echo
-    echo "To upload to CDN, run:"
-    echo "  ./scripts/upload-cdn.sh --upload"
-    echo "(configure CDN_RSYNC_TARGET, CDN_RCLONE_REMOTE, or CDN_UPLOAD_CMD)"
-fi