jackaltx · jackaltx · Jun 23, 2026 · May 21, 2026 · May 21, 2026 · May 21, 2026
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -1,13 +1,19 @@
-# CLAUDE.md - solti-containers Collection
+# CLAUDE.md - solti-podman Collection
 
-This file provides guidance to Claude Code when working in the **solti-containers** collection.
+This file provides guidance to Claude Code when working in the **solti-podman** collection.
 
-**Context**: This is one collection within the [SOLTI Ansible Collections Suite](../CLAUDE.md). The parent project coordinates multiple collections (solti-monitoring, solti-containers, solti-ensemble) with the [mylab orchestrator](../mylab/).
+**Context**: This is one collection within the [SOLTI Ansible Collections Suite](../CLAUDE.md). The parent project coordinates multiple collections (solti-monitoring, solti-podman, solti-ensemble) with the [mylab orchestrator](../mylab/).
 
 **Scope**: This CLAUDE.md covers collection-specific patterns. For system-wide context (reference machines, orchestrator workflows, cross-collection coordination), see [../CLAUDE.md](../CLAUDE.md).
 
 ## Core Commands
 
+> **Surfacing to unified docs:** Update `solti-docs.yml` at the collection root
+> to declare which files and CLAUDE.md sections should appear on solti.jackaltx.com.
+> Local `docs/` detail stays local — only declare what matters to the suite-wide audience.
+> See [solti-docs/HARVEST.md](https://github.com/jackaltx/solti-docs/blob/main/HARVEST.md).
+
+
 ### Service Management
 
 ```bash

diff --git a/JACKALTX.md b/JACKALTX.md
@@ -1,4 +1,4 @@
-# Ansible Collection - jackaltx.solti_containers
+# Ansible Collection - jackaltx.solti_podman
 
 This was an experiment to explore how to use an AI to create new container services quickly based on "convention".
 The question was,  what kinds of conventions could it learn and keep repeating. In that endeavor there were many "Plan this.." and "Summarize this...". I tried a few Claude slash commands out. Oh, the sounds of learning that came from my

diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-# SOLTI Containers - Lightweight Development Services
+# SOLTI Podman - Lightweight Development Services
 
 > **A comprehensive Ansible collection for deploying containerized development and testing services using Podman, Quadlets, and systemd integration.**
 
@@ -8,7 +8,7 @@
 
 | Attribute | Value |
 |-----------|-------|
-| **Collection** | `jackaltx.solti_containers` |
+| **Collection** | `jackaltx.solti_podman` |
 | **Container Runtime** | Podman (rootless) |
 | **Service Management** | Systemd user services via Quadlets |
 | **Network** | `ct-net` (shared container network with DNS) |
@@ -371,7 +371,7 @@ loginctl enable-linger $USER
 ## 📁 Project Structure
 
 ```
-solti-containers/
+solti-podman/
 ├── roles/                          # Service role definitions
 │   ├── _base/                      # Common functionality
 │   │   ├── tasks/
@@ -790,7 +790,7 @@ This section provides structured information for AI documentation tools and code
 ### Collection Metadata
 
 ```yaml
-collection_name: jackaltx.solti_containers
+collection_name: jackaltx.solti_podman
 collection_type: ansible_collection
 namespace: jackaltx
 version: 1.0.0

diff --git a/backup-before-cleanup.sh b/backup-before-cleanup.sh
@@ -13,8 +13,8 @@ set -euo pipefail
 
 # Configuration
 TIMESTAMP=$(date +%Y%m%d-%H%M%S)
-BACKUP_DIR="${HOME}/backups/ansible/solti-containers"
-REPO_NAME="solti-containers"
+BACKUP_DIR="${HOME}/backups/ansible/solti-podman"
+REPO_NAME="solti-podman"
 
 # Colors for output
 RED='\033[0;31m'

diff --git a/bin/matrix-log.py b/bin/matrix-log.py
@@ -4,7 +4,7 @@
 
 This script sends structured log messages to a Matrix room for
 tracking deployments, task executions, tests, and other events
-in the solti-containers collection.
+in the solti-podman collection.
 
 Jackal Says:  This is a synapse matrix bot experiment. E2EE is important!
 

diff --git a/create_symlinks.sh b/create_symlinks.sh
@@ -4,5 +4,5 @@
 mkdir -p ~/.ansible/collections/ansible_collections/jackaltx/
 
 # Create the symlink
-ln -s $(pwd) ~/.ansible/collections/ansible_collections/jackaltx/solti_containers
+ln -s $(pwd) ~/.ansible/collections/ansible_collections/jackaltx/solti_podman
 
diff --git a/docs/DNS-Service-Guide.md b/docs/DNS-Service-Guide.md
@@ -1,6 +1,6 @@
 # DNS Service - Quick Start Guide
 
-Automated DNS management for solti-containers services using Linode DNS.
+Automated DNS management for solti-podman services using Linode DNS.
 
 ## Prerequisites
 

diff --git a/docs/README.md b/docs/README.md
@@ -1,19 +1,19 @@
-# solti-containers/docs - Development Documentation
+# solti-podman/docs - Development Documentation
 
 > **Patterns, Architectures, and Development Guides**
-> *Comprehensive technical documentation for the solti-containers collection, covering patterns, decisions, and development workflows.*
+> *Comprehensive technical documentation for the solti-podman collection, covering patterns, decisions, and development workflows.*
 
 ## Purpose
 
-This directory contains technical documentation, architectural decisions, development patterns, and sprint reports for the solti-containers Ansible collection.
+This directory contains technical documentation, architectural decisions, development patterns, and sprint reports for the solti-podman Ansible collection.
 
 ## Document Categories
 
 ### Architecture & Design Patterns
 
 #### [Container-Role-Architecture.md](Container-Role-Architecture.md)
 
-Complete architecture guide for the solti-containers pattern.
+Complete architecture guide for the solti-podman pattern.
 
 **For:** Developers (human)
 **Topics:**
@@ -137,7 +137,7 @@ Guide for using Claude AI for code review.
 
 #### [molecule-strategy.md](molecule-strategy.md)
 
-Molecule testing strategy for solti-containers.
+Molecule testing strategy for solti-podman.
 
 **For:** Developers (testing guide)
 **Topics:**
@@ -253,14 +253,14 @@ Should provide:
 
 ## Related Documentation
 
-- **[solti-containers README](../README.md)** - User-facing documentation
-- **[solti-containers CLAUDE.md](../CLAUDE.md)** - Collection-specific context
+- **[solti-podman README](../README.md)** - User-facing documentation
+- **[solti-podman CLAUDE.md](../CLAUDE.md)** - Collection-specific context
 - **[Root CLAUDE.md](../../CLAUDE.md)** - Multi-collection development context
 - **[solti-docs repository](https://github.com/jackaltx/solti-docs)** - Public philosophy docs
 
 ## Usage Notes
 
-**Target Audience:** Primarily for developers working on solti-containers and those implementing similar patterns.
+**Target Audience:** Primarily for developers working on solti-podman and those implementing similar patterns.
 
 **Not User Documentation:** For user guides, see the main [README.md](../README.md) and role-specific READMEs.
 

diff --git a/docs/Security-Audit-20260412.md b/docs/Security-Audit-20260412.md
@@ -1,7 +1,7 @@
 # Security Audit Report - April 12, 2026
 
 ## Overview
-This document summarizes the findings and recommendations from a security audit of the **solti-containers** collection. The audit focused on secrets management, container isolation, and system-level configuration within the Ansible-driven rootless Podman architecture.
+This document summarizes the findings and recommendations from a security audit of the **solti-podman** collection. The audit focused on secrets management, container isolation, and system-level configuration within the Ansible-driven rootless Podman architecture.
 
 ## 1. High-Impact Findings
 

diff --git a/docs/archive/Claude-new-quadlet.md b/docs/archive/Claude-new-quadlet.md
@@ -392,7 +392,7 @@ MONGO_INITDB_DATABASE={{ mongodb_database }}
 
 ```yaml
 # MongoDB configuration file
-# Generated by Ansible for {{ ansible_managed | default('solti-containers') }}
+# Generated by Ansible for {{ ansible_managed | default('solti-podman') }}
 
 # Network settings
 net:

diff --git a/docs/archive/docker-podman-synergy-exploration.md b/docs/archive/docker-podman-synergy-exploration.md
@@ -1,13 +1,13 @@
 # Docker-Podman Synergy Exploration
 
 **Date:** 2025-12-01
-**Context:** Comparing solti-containers (Podman/dev tools) with TrueNAS Docker (persistent services)
+**Context:** Comparing solti-podman (Podman/dev tools) with TrueNAS Docker (persistent services)
 
 ---
 
 ## 🎯 Core Insight: Different Missions, Shared DNA
 
-**solti-containers (Podman):** Development/testing tools - ephemeral workloads
+**solti-podman (Podman):** Development/testing tools - ephemeral workloads
 **TrueNAS (Docker):** Production infrastructure - persistent services
 
 But underneath, they share nearly **identical lifecycle requirements**.
@@ -18,7 +18,7 @@ But underneath, they share nearly **identical lifecycle requirements**.
 
 ### Current State Comparison
 
-| Phase | Podman (solti-containers) | Docker (TrueNAS) | Gap |
+| Phase | Podman (solti-podman) | Docker (TrueNAS) | Gap |
 |-------|--------------------------|------------------|-----|
 | **Initialize** | `./manage-svc.sh redis prepare`<br>Creates dirs, SELinux contexts, network | Manual: `mkdir /mnt/zpool/Docker/Stacks/redis`<br>`chown 1000:1000 ...` | ❌ No automation |
 | **Deploy** | `./manage-svc.sh redis deploy`<br>Templates Quadlets → systemd → verify | Manual: `cd redis && sudo docker compose up -d` | ❌ No templating |
@@ -379,7 +379,7 @@ solti-common/          # Shared library repo
 └── docs/
     └── Service-Pattern.md       # Architecture docs
 
-solti-containers/      # Podman-specific
+solti-podman/      # Podman-specific
 ├── roles/
 │   ├── _base/         # Includes solti-common/service_base
 │   └── redis/         # Podman Quadlet templates
@@ -408,7 +408,7 @@ true-docker/           # Docker-specific
 
 ## 📋 Concrete Next Steps for TrueNAS
 
-Based on solti-containers patterns, your TrueNAS project needs:
+Based on solti-podman patterns, your TrueNAS project needs:
 
 ### 1. **Lifecycle Automation** (Missing entirely)
 
@@ -575,7 +575,7 @@ Every service inherits this pattern.
 
 ## 🤔 The Deeper Question: Should You?
 
-**Arguments FOR adopting solti-containers patterns:**
+**Arguments FOR adopting solti-podman patterns:**
 - ✅ Consistent lifecycle across all container platforms
 - ✅ Reduced duplication (11 services × 20 lines Traefik labels = 220 lines eliminated)
 - ✅ Verification framework catches deployment issues
@@ -594,7 +594,7 @@ The synergy is **very strong** for the lifecycle/verification/inventory patterns
 
 - **< 5 services:** Hand-written compose files fine, Arcane GUI sufficient
 - **5-15 services:** Template generation starts paying off (you're at 11)
-- **15+ services:** Automation essential, solti-containers patterns mandatory
+- **15+ services:** Automation essential, solti-podman patterns mandatory
 
 Since you're evaluating TrueNAS for "persistent containers" vs Podman for "dev tools," I'd suggest:
 

diff --git a/docs/archive/matrix-logging-setup.md b/docs/archive/matrix-logging-setup.md
@@ -1,6 +1,6 @@
 # Matrix Development Logging System
 
-Automated logging system for solti-containers deployments, tasks, and tests to Matrix room.
+Automated logging system for solti-podman deployments, tasks, and tests to Matrix room.
 
 ## Overview
 
@@ -59,7 +59,7 @@ ansible-playbook playbooks/create-matrix-logger-room.yml
 
 **Creates**:
 - Room: "SOLTI Containers - Development Logs"
-- Alias: `#solti-containers-dev:jackaltx.com`
+- Alias: `#solti-podman-dev:jackaltx.com`
 - Room ID: `mylab/data/matrix-logger-room.txt` (mode 0600)
 
 **Alternative (Manual)**:
@@ -77,7 +77,7 @@ cd /home/lavender/sandbox/ansible/jackaltx/mylab
 ```
 
 **Creates**:
-- Config: `solti-containers/data/matrix-logger.conf` (mode 0600)
+- Config: `solti-podman/data/matrix-logger.conf` (mode 0600)
 
 ---
 
@@ -86,7 +86,7 @@ cd /home/lavender/sandbox/ansible/jackaltx/mylab
 ### Manual Logging
 
 ```bash
-cd /home/lavender/sandbox/ansible/jackaltx/solti-containers
+cd /home/lavender/sandbox/ansible/jackaltx/solti-podman
 
 # Simple message
 ./bin/matrix-log.py message "Test deployment started"
@@ -169,7 +169,7 @@ Attached in custom field `dev.solti.log_data`:
 
 1. Open https://matrix.jackaltx.com
 2. Login
-3. Find room: `#solti-containers-dev:jackaltx.com`
+3. Find room: `#solti-podman-dev:jackaltx.com`
 4. View messages and JSON data
 
 ### Via API (Future)
@@ -182,7 +182,7 @@ Query structured data for dashboards, reports, or automation.
 
 ### Config File
 
-Location: `solti-containers/data/matrix-logger.conf`
+Location: `solti-podman/data/matrix-logger.conf`
 
 ```json
 {
@@ -222,15 +222,15 @@ ls -l mylab/data/matrix-logger-token.txt
 ls -l mylab/data/matrix-logger-room.txt
 
 # Check config exists
-ls -l solti-containers/data/matrix-logger.conf
+ls -l solti-podman/data/matrix-logger.conf
 
 # Check script is executable
-ls -l solti-containers/bin/matrix-log.py
+ls -l solti-podman/bin/matrix-log.py
 ```
 
 **Test manually**:
 ```bash
-cd /home/lavender/sandbox/ansible/jackaltx/solti-containers
+cd /home/lavender/sandbox/ansible/jackaltx/solti-podman
 ./bin/matrix-log.py --dry-run message "Test"
 # Should print message without errors
 
@@ -240,7 +240,7 @@ cd /home/lavender/sandbox/ansible/jackaltx/solti-containers
 
 **Check script is found**:
 ```bash
-cd /home/lavender/sandbox/ansible/jackaltx/solti-containers
+cd /home/lavender/sandbox/ansible/jackaltx/solti-podman
 [[ -x "./bin/matrix-log.py" ]] && echo "Found and executable" || echo "NOT FOUND or NOT EXECUTABLE"
 ```
 
@@ -272,14 +272,14 @@ Logging is designed to NEVER break deployments:
 **If deployments break**:
 ```bash
 # Disable logging temporarily
-chmod -x /home/lavender/sandbox/ansible/jackaltx/solti-containers/bin/matrix-log.py
+chmod -x /home/lavender/sandbox/ansible/jackaltx/solti-podman/bin/matrix-log.py
 
 # Scripts will skip logging (checks -x flag)
 ```
 
 **Re-enable**:
 ```bash
-chmod +x /home/lavender/sandbox/ansible/jackaltx/solti-containers/bin/matrix-log.py
+chmod +x /home/lavender/sandbox/ansible/jackaltx/solti-podman/bin/matrix-log.py
 ```
 
 ---
@@ -290,7 +290,7 @@ chmod +x /home/lavender/sandbox/ansible/jackaltx/solti-containers/bin/matrix-log
 
 Remove execute permission:
 ```bash
-chmod -x solti-containers/bin/matrix-log.py
+chmod -x solti-podman/bin/matrix-log.py
 ```
 
 Scripts check `-x` flag and skip logging automatically.
@@ -299,7 +299,7 @@ Scripts check `-x` flag and skip logging automatically.
 
 Remove integration from scripts:
 ```bash
-cd solti-containers
+cd solti-podman
 git checkout manage-svc.sh svc-exec.sh
 ```
 
@@ -340,13 +340,13 @@ git checkout manage-svc.sh svc-exec.sh
 - `data/matrix-logger-token.txt` - Access token (auto-generated)
 - `data/matrix-logger-room.txt` - Room ID (auto-generated)
 
-**solti-containers/** (logging):
+**solti-podman/** (logging):
 - `bin/matrix-log.py` - Core logging script
 - `data/matrix-logger.conf` - Config file (auto-generated)
 
 ### Modified Files
 
-**solti-containers/**:
+**solti-podman/**:
 - `manage-svc.sh` - Added deployment logging hooks
 - `svc-exec.sh` - Added task execution logging hooks
 

diff --git a/docs/decisions/URL-Standardization-Plan.md b/docs/decisions/URL-Standardization-Plan.md
@@ -2,7 +2,7 @@
 
 **Date:** 2025-11-18
 **Status:** In Progress (Gitea Complete)
-**Purpose:** Standardize service URL construction across all solti-containers roles for multi-host deployments
+**Purpose:** Standardize service URL construction across all solti-podman roles for multi-host deployments
 
 ---
 

diff --git a/docs/inventory/Inventory-Architecture-Goals.md b/docs/inventory/Inventory-Architecture-Goals.md
@@ -240,7 +240,7 @@ elasticsearch_password: "{{ lookup('env', 'ELASTICSEARCH_PASSWORD') }}"
 **Future State**: External secrets repository
 
 ```
-solti-containers/                    # Public repository
+solti-podman/                    # Public repository
 ├── inventory/
 │   └── group_vars/
 │       └── elasticsearch_svc.yml    # No secrets, references only
@@ -288,7 +288,7 @@ ansible-playbook -i inventory/localhost.yml \
 - name: Deploy monitoring stack
   workflow:
     collections:
-      - solti-containers
+      - solti-podman
     inventory: ~/lab-inventory
     secrets: ~/lab-secrets
     targets:
@@ -316,7 +316,7 @@ ansible-playbook -i inventory/localhost.yml \
 - Send notifications
 - Record audit trail
 
-**Collection responsibilities** (solti-containers):
+**Collection responsibilities** (solti-podman):
 
 - Implement service deployment roles
 - Provide verification tasks