Deps Checker
🛡️ File Information
| Property | Value |
|---|---|
| Binary Name | deps-checker |
| Version | 9.0.1 |
| File Size | 4.6MB |
| Author | Warith Al Maawali |
| License | Proprietary |
| Category | Infrastructure & Management |
| Description | Dependency checker for Kodachi OS Rust binaries - Validates system dependencies and generates instal... |
| JSON Data | View Raw JSON |
SHA256 Checksum
🛡️ Key Features
Dependency Management
| Feature | Description |
|---|---|
| Comprehensive Scanning | Identifies all dependencies for Rust services |
| Validation Engine | Verifies each dependency is installed and working |
| Auto-Installation | Generates scripts to install missing dependencies |
| Version Checking | Ensures dependencies meet minimum version requirements |
Why Deps Checker is Critical
| Benefit | Description |
|---|---|
| Service Reliability | Prevents services from failing due to missing dependencies |
| System Validation | Ensures system is properly configured |
| Quick Recovery | Rapidly identifies and fixes dependency issues |
| Installation Helper | Simplifies setup on new systems |
🛡️ ⚡ TL;DR - Essential Commands
# Check dependencies for a specific binary
deps-checker check dns-switch
# Check all binaries
deps-checker check-all
# Install missing packages for all binaries
sudo deps-checker install-missing all
# List all known binaries
deps-checker list-binaries
🛡️ Understanding Dependency Management
How Deps Checker Works
Deps Checker analyzes each Rust binary to determine its requirements:
# Check dependencies for all services
deps-checker check-all
# What it checks:
# - System libraries (OpenSSL, libcurl, etc.)
# - Runtime dependencies (Python, Node.js if needed)
# - Configuration files
# - Network tools (iptables, nftables, etc.)
Checking Services
Analyze specific services for dependencies:
# Check single service
deps-checker check ip-fetch
# Check with specific profile (minimal or full)
deps-checker check ip-fetch --profile minimal
# Check all services
deps-checker check-all
# Check all with JSON output
deps-checker check-all --json
Verification Process
# Check all dependencies and their status
deps-checker check-all
# Output shows:
# ✓ OpenSSL 3.0.2 - INSTALLED
# ✓ libcurl 7.81.0 - INSTALLED
# ✗ nftables - MISSING
# ⚠ iptables 1.8.4 - VERSION TOO OLD (need 1.8.7+)
# Save report to file
deps-checker check-all --json -o deps-check-report.json
# Quick pass/fail for CI
deps-checker check-all --json | jq -e '.summary.with_missing == 0' >/dev/null
Generating Installation Scripts
When dependencies are missing:
# Generate installation script from check results
deps-checker check-all --json | deps-checker generate-script
# Generate for different shells
deps-checker check-all --json | deps-checker generate-script --shell zsh
# Generate and execute immediately (review before executing)
deps-checker check-all --json | sudo deps-checker generate-script --execute
# Preview without executing
deps-checker check-all --json | deps-checker generate-script --dry-run
Dependency Reports
Generate comprehensive dependency documentation:
# Generate full dependency check report
deps-checker check-all --json -o deps-check-report.json
# Generate Software Bill of Materials (SBOM)
deps-checker check-all --sbom -o deps-check-sbom.json
# Review report summary with jq
cat deps-check-report.json | jq '.summary'
# Check if all dependencies satisfied (exit code check)
deps-checker check-all --json | jq '.summary.exit_code'
Service-Specific Dependencies
Each service has unique requirements:
# Check routing-switch dependencies
deps-checker check routing-switch
# Requires: openvpn, wireguard-tools, tun2socks
# Check health-control dependencies with minimal profile
deps-checker check health-control -p minimal
# Core dependencies only
# Check health-control with full profile
deps-checker check health-control -p full
# Includes audio, security tools, etc.
# List available profiles for a binary
deps-checker list-profiles health-control
Fixing Missing Dependencies
# Install missing packages for specific binary
sudo deps-checker install-missing dns-leak
# Install all missing packages system-wide
sudo deps-checker install-missing all
# What it does:
# 1. Identifies missing packages
# 2. Installs via apt-get
# 3. Verifies installation
# 4. Reports status
Dependency Profiles and Binaries
# List all supported binaries
deps-checker list-binaries
# List available profiles (minimal/full) for a binary
deps-checker list-profiles health-control
# Use custom dependency database
deps-checker check-all --db ./custom-deps-db
# Strict mode - treat warnings as errors
deps-checker check-all --strict
Common Workflows
# Typical workflow - check then install
deps-checker check-all # See what's missing
sudo deps-checker install-missing all # Install everything
# CI/CD integration - fail on warnings
deps-checker check-all --strict || exit 1
# Automated validation
deps-checker check-all --json | jq '.summary.exit_code'
# Generate and review before installing
deps-checker check-all --json | deps-checker generate-script --dry-run
🛡️ Advanced Commands
For advanced users who need access to all available commands and options, please refer to the auto-generated command reference which includes:
| Feature | Description |
|---|---|
| Custom Paths | Custom dependency paths |
| Version Constraints | Version constraint specifications |
| Platform Checks | Platform-specific checks |
| Dev Dependencies | Development dependencies |
| Container Validation | Docker/container validation |
| JSON Formatting | JSON output formatting |
| CLI Reference | All command-line flags and parameters |
🛡️ Security Notes
Important Security Practices:
| Practice | Description |
|---|---|
| Source Verification | Verify package sources before installation |
| Script Review | Review installation scripts before execution |
| Database Updates | Keep dependency database updated |
| Security Updates | Check for security updates regularly |
| Official Repos | Use official repositories only |
🛡️ Performance
| Metric | Value |
|---|---|
| Scan Speed | < 5 seconds for all services |
| Memory Usage | ~25MB during scanning |
| CPU Usage | < 10% during checks |
| Database Size | ~2MB |
| Verification Time | < 1 second per dependency |
🛡️ Support
| Resource | Link |
|---|---|
| Website | digi77.com |
| Anonymity Verifier | kodachi.cloud |
| Discord Support | discord.gg/KEFErEx |
| GitHub | github.com/WMAL |