{"id":29879380,"url":"https://github.com/scav-enger/v.k.m","last_synced_at":"2026-06-30T07:31:39.605Z","repository":{"id":304179759,"uuid":"1018020464","full_name":"Scav-engeR/V.K.M","owner":"Scav-engeR","description":"V.K.M - Virtual | Kernel | Manager -","archived":false,"fork":false,"pushed_at":"2025-08-26T17:06:43.000Z","size":75,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-26T23:58:18.170Z","etag":null,"topics":["automate","fix","kenrnel","kernel-management","kernel-manager","kvm","linux","virtual-private-cloud","vps"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Scav-engeR.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-11T13:23:53.000Z","updated_at":"2025-08-26T17:08:03.000Z","dependencies_parsed_at":"2025-07-11T15:47:04.906Z","dependency_job_id":"587751ed-f629-4fbc-beae-6ae47d15200b","html_url":"https://github.com/Scav-engeR/V.K.M","commit_stats":null,"previous_names":["scav-enger/v.k.m"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/Scav-engeR/V.K.M","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scav-engeR%2FV.K.M","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scav-engeR%2FV.K.M/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scav-engeR%2FV.K.M/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scav-engeR%2FV.K.M/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Scav-engeR","download_url":"https://codeload.github.com/Scav-engeR/V.K.M/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Scav-engeR%2FV.K.M/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34957626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automate","fix","kenrnel","kernel-management","kernel-manager","kvm","linux","virtual-private-cloud","vps"],"created_at":"2025-07-31T08:16:45.098Z","updated_at":"2026-06-30T07:31:39.600Z","avatar_url":"https://github.com/Scav-engeR.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# V.K.M\nV.K.M - Virtual | Kernel | Manager -\n# VPS Kernel Manager (VKM) v1.0\n\nAdvanced Linux Kernel Management Tool for Debian 10 (Buster) and Compatible Systems\n\n## 🚀 Features\n\n### Core Functionality\n- **Interactive CLI Interface** - Rich, user-friendly terminal interface\n- **Kernel Switching** - Seamless switching between installed kernels\n- **Automated Compilation** - Custom kernel compilation with VPS optimizations\n- **Patch Management** - Download and apply performance/security patches\n- **VPS Optimizations** - Network, memory, and I/O optimizations\n- **Security Hardening** - Kernel security configurations and audit logging\n- **Performance Benchmarking** - System performance analysis and validation\n\n### Advanced Features\n- **Multiple Kernel Variants** - Support for XanMod, Liquorix, RT kernels\n- **Automated Patching** - XanMod performance patches, security updates\n- **BBR TCP Congestion Control** - Network performance optimization\n- **Transparent Huge Pages** - Memory management optimization\n- **I/O Scheduler Selection** - Optimized disk performance\n- **Audit Logging** - Security compliance and monitoring\n- **Configuration Management** - Flexible, persistent configuration system\n\n## 📋 Prerequisites\n\n### System Requirements\n- **OS**: Debian 10 (Buster) or compatible (Ubuntu 18.04+)\n- **Architecture**: x86_64 (amd64)\n- **Memory**: 1GB+ RAM (2GB+ recommended for compilation)\n- **Storage**: 2GB+ free space\n- **Root Access**: Required for system operations\n\n### Dependencies (Auto-installed)\n- Python 3.6+\n- Build tools (gcc, make, etc.)\n- Kernel build dependencies\n- Rich CLI library\n- Click framework\n\n## 🔧 Installation\n\n### Quick Install\n```bash\n# Download the installer\nwget https://raw.githubusercontent.com/your-repo/vkm/main/install.sh\n\n# Make executable and run\nchmod +x install.sh\nsudo ./install.sh\n```\n\n### Manual Install\n```bash\n# Clone repository\ngit clone https://github.com/your-repo/vkm.git\ncd vkm\n\n# Run installer\nsudo ./install.sh\n```\n\n### Verification\n```bash\n# Check installation\nvkm --version\nvkm info\n```\n\n## 🎮 Usage\n\n### Interactive Mode (Recommended)\n```bash\n# Start interactive interface\nsudo vkm interactive\n```\n\nThe interactive mode provides a menu-driven interface with:\n- System information display\n- Kernel management options\n- Real-time progress indicators\n- Configuration management\n- Help and guidance\n\n### Command Line Interface\n\n#### System Information\n```bash\n# Show system details\nvkm info\n\n# List available kernels\nvkm list-kernels\n```\n\n#### Kernel Management\n```bash\n# Switch to specific kernel\nsudo vkm switch 5.4.0-74-generic\n\n# Compile custom kernel\nsudo vkm compile --version latest --optimization vps\n\n# Compile with specific options\nsudo vkm compile --version 5.15.0 --optimization performance\n```\n\n#### Optimization\n```bash\n# Apply all VPS optimizations\nsudo vkm optimize\n\n# Apply specific optimizations\nsudo vkm optimize --type network\nsudo vkm optimize --type memory\nsudo vkm optimize --type io\n```\n\n#### Patch Management\n```bash\n# Download XanMod performance patches\nsudo vkm patch\n\n# Download custom patch\nsudo vkm patch --url https://example.com/patch.patch --name custom-patch\n```\n\n#### Security\n```bash\n# Apply security hardening\nsudo vkm harden\n```\n\n#### Benchmarking\n```bash\n# Run performance benchmark\nvkm benchmark\n```\n\n## ⚙️ Configuration\n\n### Configuration File\nLocation: `/etc/vkm/vkm.conf` or `~/.vkm/config.ini`\n\n```ini\n[general]\nbuild_dir = /tmp/vkm-build\nkernel_source_dir = /usr/src\ndefault_optimization = O2\nparallel_jobs = 4\nauto_backup = true\nmax_kernels = 5\n\n[compilation]\ncompiler = gcc\nenable_lto = false\nenable_pgo = false\ncustom_cflags = -march=native\ndebug_info = false\n\n[vps]\ntcp_congestion = bbr\nio_scheduler = mq-deadline\ntransparent_hugepages = madvise\nvm_swappiness = 1\nenable_thp = true\n\n[security]\nenable_hardening = true\nsecure_boot = false\nsign_modules = false\naudit_logging = true\n\n[patches]\nauto_download = true\npatch_sources = https://github.com/xanmod/linux-patches\nsecurity_patches = true\nperformance_patches = true\n```\n\n### Kernel Optimization Levels\n\n#### VPS (Default)\n- Virtualization support optimized\n- BBR TCP congestion control\n- mq-deadline I/O scheduler\n- Memory management for VPS\n- Security hardening enabled\n\n#### Performance\n- Preemptible kernel (PREEMPT)\n- 1000Hz timer frequency\n- Aggressive CPU optimizations\n- Minimal debugging\n\n#### Minimal\n- Monolithic kernel (no modules)\n- Minimal feature set\n- Optimized for size\n- Fastest boot time\n\n## 🔍 Advanced Usage\n\n### Custom Kernel Compilation\n\n#### Optimization Flags\n```bash\n# VPS-optimized build\nsudo vkm compile --optimization vps\n\n# Performance-focused build\nsudo vkm compile --optimization performance\n\n# Minimal build for containers\nsudo vkm compile --optimization minimal\n```\n\n#### Custom Configuration\n```bash\n# Use specific compiler\nvkm config set compilation compiler clang\n\n# Enable Link Time Optimization\nvkm config set compilation enable_lto true\n\n# Custom CFLAGS\nvkm config set compilation custom_cflags \"-march=native -O3\"\n```\n\n### Patch Management\n\n#### XanMod Patches\n- **BBRv3**: Latest TCP congestion control\n- **CACULE Scheduler**: Interactive task scheduling\n- **Multigenerational LRU**: Advanced memory management\n- **LE9 Patches**: Low latency optimizations\n\n#### Security Patches\n- Automatic CVE patch detection\n- Kernel hardening patches\n- Security backports\n\n#### Custom Patches\n```bash\n# Apply custom patch to kernel source\nsudo vkm patch --url https://lkml.org/patch.mbox --name security-fix\n\n# Apply patch during compilation\nsudo vkm compile --patches custom-patch.patch\n```\n\n### VPS Optimizations\n\n#### Network Optimization\n- BBR/BBRv3 TCP congestion control\n- Increased network buffers\n- TCP window scaling\n- Fast open connections\n\n#### Memory Optimization\n- Low swappiness (vm.swappiness=1)\n- Optimized cache pressure\n- Transparent huge pages\n- Dirty page write optimization\n\n#### I/O Optimization\n- mq-deadline scheduler for SSDs\n- BFQ scheduler for HDDs\n- Optimized queue depths\n- Read-ahead optimization\n\n### Security Hardening\n\n#### Kernel Security\n- Address space layout randomization\n- Stack protection\n- Hardened user copy\n- Restricted dmesg access\n\n#### Audit Logging\n- Kernel module monitoring\n- System call auditing\n- File access monitoring\n- Security event logging\n\n## 📊 Performance Benchmarking\n\n### Network Benchmarks\n- TCP throughput testing\n- Latency measurements\n- Congestion control validation\n- Multi-connection testing\n\n### Disk Benchmarks\n- Sequential read/write speeds\n- Random I/O performance\n- I/O scheduler comparison\n- Latency analysis\n\n### Memory Benchmarks\n- Memory bandwidth testing\n- Cache performance\n- THP effectiveness\n- Swap usage analysis\n\n## 🛠️ Troubleshooting\n\n### Common Issues\n\n#### Compilation Failures\n```bash\n# Check build dependencies\nsudo apt install build-essential linux-source\n\n# Verify disk space\ndf -h /tmp\n\n# Check memory availability\nfree -h\n```\n\n#### Boot Issues\n```bash\n# Access GRUB menu during boot\n# Select \"Advanced options\"\n# Choose previous kernel\n\n# Or use recovery mode\n# Mount filesystem read-write\n# Edit /etc/default/grub\n# Run update-grub\n```\n\n#### Performance Issues\n```bash\n# Verify optimizations are applied\nvkm benchmark\n\n# Check sysctl settings\nsysctl net.ipv4.tcp_congestion_control\nsysctl vm.swappiness\n\n# Monitor system performance\nhtop\niotop\n```\n\n### Logs and Debugging\n```bash\n# VKM logs\ntail -f /var/log/vkm/vkm_$(date +%Y%m%d).log\n\n# Kernel logs\ndmesg | tail -50\n\n# System logs\njournalctl -f\n\n# Compilation logs\ntail -f /tmp/vkm-build/build.log\n```\n\n## 🔒 Security Considerations\n\n### Kernel Security\n- Only use trusted patch sources\n- Verify signatures when possible\n- Test kernels in non-production first\n- Maintain kernel backups\n\n### System Security\n- Regular security updates\n- Monitor audit logs\n- Use secure boot when possible\n- Keep build environment isolated\n\n## 📈 Performance Tuning\n\n### Network Performance\n```bash\n# Optimize for high bandwidth\necho 'net.core.rmem_max = 268435456' \u003e\u003e /etc/sysctl.conf\necho 'net.core.wmem_max = 268435456' \u003e\u003e /etc/sysctl.conf\n\n# Enable BBR\necho 'net.ipv4.tcp_congestion_control = bbr' \u003e\u003e /etc/sysctl.conf\n\n# Apply changes\nsysctl -p\n```\n\n### Memory Performance\n```bash\n# Optimize for VPS\necho 'vm.swappiness = 1' \u003e\u003e /etc/sysctl.conf\necho 'vm.vfs_cache_pressure = 10' \u003e\u003e /etc/sysctl.conf\n\n# Configure THP\necho madvise \u003e /sys/kernel/mm/transparent_hugepage/enabled\n```\n\n### I/O Performance\n```bash\n# Set optimal I/O scheduler\necho mq-deadline \u003e /sys/block/sda/queue/scheduler\n\n# Optimize queue depth\necho 32 \u003e /sys/block/sda/queue/nr_requests\n```\n\n## 🔄 Maintenance\n\n### Regular Tasks\n- Monitor kernel security advisories\n- Update patches monthly\n- Benchmark performance quarterly\n- Review audit logs weekly\n\n### Automated Maintenance\n```bash\n# Enable automatic monitoring\nsudo systemctl enable vkm-monitor.timer\n\n# Schedule weekly optimization checks\nsudo crontab -e\n# Add: 0 2 * * 1 /usr/local/bin/vkm optimize --auto\n```\n\n## 🆘 Support and Contributing\n\n### Getting Help\n- Check logs: `/var/log/vkm/`\n- Run diagnostics: `vkm info`\n- Review configuration: `vkm config show`\n\n### Reporting Issues\nInclude:\n- VKM version: `vkm --version`\n- System info: `vkm info`\n- Error logs: `/var/log/vkm/`\n- Steps to reproduce\n\n### Contributing\n- Fork the repository\n- Create feature branch\n- Add tests for new features\n- Submit pull request\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## ⚠️ Disclaimer\n\nThis tool modifies kernel configurations and system settings. While designed for safety:\n- Always test in non-production environments first\n- Maintain current kernel backups\n- Understand the implications of changes\n- Use at your own risk\n\nVKM is not affiliated with any kernel maintainers or distributions.\n\n## 🔗 References\n\n- [Linux Kernel Documentation](https://www.kernel.org/doc/)\n- [XanMod Kernel](https://xanmod.org/)\n- [BBR Congestion Control](https://github.com/google/bbr)\n- [Debian Kernel Handbook](https://kernel-team.pages.debian.net/kernel-handbook/)\n- [VPS Optimization Guide](https://wiki.archlinux.org/title/Improving_performance)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscav-enger%2Fv.k.m","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscav-enger%2Fv.k.m","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscav-enger%2Fv.k.m/lists"}