Documentation Navigation
Navigate the documentation:
Enterprise-Grade Service Infrastructure and Management
The infrastructure tools in Kodachi OS provide the foundational service layer for logging, dependency management, service deployment, and information control. These production-ready binaries ensure reliable system operation through centralized logging, automated deployment, and comprehensive dependency validation.
Core Architecture Principles - Verified
Centralized Management: Single point of control for logs, dependencies, and deployments
Zero Configuration: Embedded configurations with no external YAML dependencies
Service Orchestration: Automated deployment and verification of all binaries
Information Control: Secure management of online exposure and data feeds
Binary Categories and Requirements
| Binary |
Primary Function |
Commands |
Requires Auth |
Requires Sudo |
Auto-Start |
| logs-hook |
Centralized secure logging infrastructure |
3 |
No |
Yes (system logs) |
Auto-integrated |
| deps-checker |
Dependency validation and security auditing |
4 |
No |
Yes (install) |
No |
| global-launcher |
System-wide binary deployment manager |
3 |
No |
Yes (global) |
Called by online-auth |
| workflow-manager |
Batch command execution with conditional logic |
9 |
Yes (11%) |
Yes (system ops) |
No |
| online-info-switch |
Online information hub and RSS feeds |
12 |
Yes |
Yes (system ops) |
No |
Inter-Binary Dependencies Matrix
Binary Communication Flow
| Service |
Calls These Binaries |
Called By These Binaries |
| logs-hook |
None |
ALL binaries (auto-integrated in all services) |
| deps-checker |
logs-hook |
None |
| global-launcher |
logs-hook |
online-auth |
| workflow-manager |
logs-hook |
None (user-initiated) |
| online-info-switch |
logs-hook, online-auth, health-control |
None |
Critical Service Dependencies
| Dependency Type |
Description |
Affected Services |
| Logging Integration |
All services automatically integrate logs-hook |
ALL Kodachi binaries |
| Deployment Chain |
Services deployed by global-launcher |
All Rust and Gambas binaries |
| Authentication |
Services requiring online-auth |
online-info-switch |
| System Health |
Services using health-control |
online-info-switch |
System Requirements and Permissions
Privilege Escalation Requirements
| Operation Type |
Required Permissions |
Affected Binaries |
| System Logging |
sudo/root |
logs-hook (system-wide logs) |
| Package Installation |
sudo/root |
deps-checker (apt-get operations) |
| Global Deployment |
sudo/root |
global-launcher (/usr/local/bin) |
| System Operations |
sudo/root |
online-info-switch (network checks) |
Service Integration Levels
| Integration Level |
Method |
Services |
| Embedded |
Compiled into binary |
logs-hook in all services |
| System-wide |
Global symlinks |
global-launcher deployments |
| Package Manager |
APT/dpkg integration |
deps-checker |
| Network APIs |
HTTPS with cert pinning |
online-info-switch |
Key Capabilities Overview
Workflow Management (workflow-manager - 9 commands)
| Feature |
Description |
| Template Creation |
Create reusable workflow templates |
| Batch Execution |
Execute multiple commands sequentially |
| Conditional Logic |
Hybrid conditions: success/fail + pattern matching + JSON path |
| Pause Steps |
Interactive pause points with user confirmation |
| State Tracking |
Maintain workflow execution state |
| Telemetry Logging |
Comprehensive execution logs in JSONL format |
| Retry Logic |
Built-in retry mechanisms for failed steps |
| Timeout Control |
Configurable timeouts per step |
| Dry Run Mode |
Test workflows without execution |
Centralized Logging (logs-hook - 3 commands)
| Feature |
Description |
| Log Levels |
Multiple levels: info, warn, error, debug, fatal |
| Script Categorization |
Script-based log categorization |
| JSON Output |
JSON format for automation |
| Log Rotation |
Automatic rotation with size limits |
| Secure Wiping |
Secure wiping with verification |
| Selective Operations |
Selective file operations |
| Auto-embedded |
Embedded in all binaries |
| Centralized Storage |
/dashboard/hooks/logs/ directory |
| Structured Format |
Consistent logging format |
Dependency Management (deps-checker - 4 commands)
| Feature |
Description |
| Single Binary Check |
Dependency checking for individual binaries |
| System-wide Audit |
Complete dependency audit across system |
| Profile-based Checking |
Minimal/full profile options |
| Auto Installation |
Automatic missing package installation |
| Script Generation |
Generate install scripts for multiple shells |
| SBOM Generation |
Software Bill of Materials generation |
| Database Support |
External dependency database |
| Version Tracking |
Track dependency versions |
| Security Audit |
Integration with security auditing |
Binary Deployment (global-launcher - 3 commands)
| Feature |
Description |
| Dynamic Discovery |
Automatic binary discovery |
| Global Symlinks |
Create symlinks in /usr/local/bin |
| Multi-language Support |
Support for Rust and Gambas binaries |
| Status Checking |
Deployment status verification |
| Integrity Verification |
Symlink integrity checks |
| Rollback |
Rollback capabilities |
| Folder Containment |
Execution folder containment |
| Permission Preservation |
Maintain file permissions |
| Atomic Operations |
Ensure operation atomicity |
| Feature |
Description |
| Status Detection |
Online/offline status detection |
| RSS Feeds |
Security RSS feed aggregation |
| Paste Services |
Public paste service integration |
| Proof of Freshness |
News + blockchain verification |
| Crypto Prices |
Cryptocurrency price monitoring |
| Wallet Balance |
Bitcoin wallet balance checking |
| Certificate Pinning |
Secure connections with cert pinning |
| Auth Verification |
Authentication verification |
| Rate Limiting |
Protection against excessive requests |
Common Workflows
Workflow Management
# Create workflow template
workflow-manager create my-workflow
# Add commands (comma-separated for multiple)
workflow-manager add my-workflow "sudo ip-fetch","sudo online-auth check-login"
# Run workflow
sudo workflow-manager run my-workflow
# Test without execution
sudo workflow-manager run my-workflow --dry-run
# List all workflows
workflow-manager list
Logging Operations
# Log a message with specific level
./logs-hook log --script "deployment" --level info "Service started"
# Rotate logs when they get large
sudo ./logs-hook maintenance rotate --file system.log
# Secure wipe of old logs
sudo ./logs-hook maintenance wipe --all
Dependency Management
# Check dependencies for specific binary
./deps-checker check health-control
# System-wide dependency audit
sudo ./deps-checker check-all --profile full
# Install missing dependencies
sudo ./deps-checker install-missing
# Generate installation script
./deps-checker generate-script --shell bash > install_deps.sh
Service Deployment
# Deploy all binaries globally
sudo ./global-launcher deploy
# Verify deployment status
./global-launcher verify
# Clean up deployments
sudo ./global-launcher cleanup
# Check online status
./online-info-switch status --json
# Get security RSS feeds
./online-info-switch rss --limit 10
# Proof of freshness
./online-info-switch freshness --json
# Cryptocurrency prices
./online-info-switch price --symbols BTC,ETH
| Metric |
Value |
Description |
| Total Commands |
31 |
Across infrastructure binaries |
| Log Processing |
10,000 lines/sec |
Maximum throughput |
| Deployment Time |
< 5 seconds |
For all binaries |
| Dependency Check |
< 2 seconds |
Per binary |
| Memory Usage |
< 50MB |
Combined services |
Infrastructure Architecture
Logging Architecture
Application → logs-hook (embedded) → Centralized Logs
↓
Log Rotation/Wiping
↓
Archive/Destruction
Dependency Flow
Binary Request → deps-checker → Package Database
↓
Validation/Installation
↓
System Packages
Deployment Pipeline
Source Binaries → global-launcher → Discovery
↓
Symlink Creation
↓
/usr/local/bin/
Service Management
Auto-Integration Features
| Feature |
Implementation |
Services |
| Logging |
Compile-time embedding |
All binaries |
| Authentication |
Runtime verification |
online-info-switch |
| Deployment |
System-wide symlinks |
All services |
| Dependencies |
Package manager integration |
System-wide |
Maintenance Operations
# Daily maintenance routine
sudo ./logs-hook maintenance rotate
sudo ./deps-checker check-all
./global-launcher verify
# Weekly maintenance
sudo ./logs-hook maintenance wipe --all
sudo ./deps-checker install-missing
Integration Points
The infrastructure tools integrate with:
| Integration Type |
Components/Description |
| All Kodachi Binaries |
Through embedded logs-hook |
| Package Managers |
APT, dpkg for dependencies |
| File System |
/usr/local/bin for deployments |
| Network Services |
RSS feeds, APIs, paste services |
| Authentication |
online-auth for secure operations |
Troubleshooting
Common Issues
| Issue |
Solution |
Prevention |
| Logs not rotating |
Check disk space, permissions |
Monitor log sizes |
| Dependencies missing |
Run install-missing |
Regular audits |
| Deployment fails |
Check sudo permissions |
Verify before deploy |
| RSS feeds empty |
Check network, authentication |
Test connectivity |
Diagnostic Commands
# Check logging system
./logs-hook log --script test --level debug "Test message"
# Verify dependencies
./deps-checker check-all --verbose
# Test deployment
sudo ./global-launcher deploy --dry-run
# Check online services
./online-info-switch status --debug
Security Considerations
Important Security Notice
Infrastructure tools have system-wide impact. Always verify operations before execution, especially deployment and package installation commands.
Security Features
| Feature |
Description |
| Embedded Configurations |
No external config files to tamper |
| Execution Containment |
Services operate within bounds |
| Certificate Pinning |
Secure network connections |
| Audit Trails |
Complete logging of operations |
| Permission Preservation |
Maintain security boundaries |
Best Practices
| Practice |
Description |
| Regular Audits |
Check dependencies weekly |
| Log Management |
Rotate and archive logs |
| Deployment Verification |
Always verify after deploy |
| Network Security |
Use authentication for online services |
| Backup Strategy |
Maintain deployment rollback capability |
Advanced Features
Log Analysis
# Search logs for errors
grep -i error /dashboard/hooks/logs/*.log
# JSON log parsing
./logs-hook log --json | jq '.level == "error"'
# Real-time monitoring
tail -f /dashboard/hooks/logs/system.log
Dependency Profiles
| Profile |
Use Case |
Packages |
| Minimal |
Core functionality |
Essential only |
| Full |
Complete feature set |
All dependencies |
| Security |
Security tools |
Audit and monitoring |
| Development |
Dev environment |
Build tools included |
Deployment Strategies
| Strategy |
Description |
Use Case |
| Full Deploy |
All binaries |
Initial setup |
| Selective |
Specific services |
Updates |
| Rollback |
Previous state |
Recovery |
| Verify Only |
Check without change |
Audit |
| Component |
Version |
Build Date |
License |
| logs-hook |
9.0.1 |
2025-09-18 |
Proprietary |
| deps-checker |
9.0.1 |
2025-09-18 |
Proprietary |
| global-launcher |
9.0.1 |
2025-09-18 |
Proprietary |
| workflow-manager |
9.0.1 |
2025-10-08 |
Proprietary |
| online-info-switch |
9.0.1 |
2025-09-18 |
Proprietary |
| Documentation |
9.0.1 |
2025-10-08 |
© 2025 Linux Kodachi |