{"id":31074124,"url":"https://github.com/0xamirreza/lxc4dev","last_synced_at":"2026-04-30T08:38:59.089Z","repository":{"id":314730482,"uuid":"1049317364","full_name":"0xamirreza/LXC4Dev","owner":"0xamirreza","description":"⚙️ A comprehensive, user-friendly LXC (Linux Containers) management suite with automated installation, interactive container management, and advanced features. Designed for both beginners and advanced users.","archived":false,"fork":false,"pushed_at":"2025-09-02T20:15:18.000Z","size":25,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"Master","last_synced_at":"2025-10-10T06:35:37.767Z","etag":null,"topics":["archlinux","bash","cachyos","container","linux","lxc","shell"],"latest_commit_sha":null,"homepage":"https://0xv.ir/lxc4dev","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xamirreza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-02T19:52:03.000Z","updated_at":"2025-10-04T13:57:46.000Z","dependencies_parsed_at":"2025-09-14T12:42:56.762Z","dependency_job_id":"c2b6f416-3a4b-46c3-85af-1f042ed5fbcf","html_url":"https://github.com/0xamirreza/LXC4Dev","commit_stats":null,"previous_names":["0xamirreza/lxc4dev"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/0xamirreza/LXC4Dev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xamirreza%2FLXC4Dev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xamirreza%2FLXC4Dev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xamirreza%2FLXC4Dev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xamirreza%2FLXC4Dev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xamirreza","download_url":"https://codeload.github.com/0xamirreza/LXC4Dev/tar.gz/refs/heads/Master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xamirreza%2FLXC4Dev/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281889542,"owners_count":26578952,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-30T02:00:06.501Z","response_time":61,"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":["archlinux","bash","cachyos","container","linux","lxc","shell"],"created_at":"2025-09-16T02:03:16.260Z","updated_at":"2025-10-30T21:50:12.955Z","avatar_url":"https://github.com/0xamirreza.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐧 Lxc4Dev - Advanced LXC Container Management Suite\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Arch Linux](https://img.shields.io/badge/Arch%20Linux-Fully%20Tested-1793D1?logo=arch-linux\u0026logoColor=white)](https://archlinux.org/)\n[![CachyOS](https://img.shields.io/badge/CachyOS-Fully%20Tested-FF6B35)](https://cachyos.org/)\n[![Shell Script](https://img.shields.io/badge/Shell-Bash-4EAA25?logo=gnu-bash\u0026logoColor=white)](https://www.gnu.org/software/bash/)\n\nA comprehensive, user-friendly LXC (Linux Containers) management suite with automated installation, interactive container management, and advanced features. Designed for both beginners and advanced users.\n\n## 🚀 Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/0xamirreza/lxc4dev.git\ncd lxc4dev\n\n# Make scripts executable\nchmod +x lxc-install.sh 0xlxc.sh\n\n# Run the installation\n./lxc-install.sh\n\n# Choose option 1 to install LXC + Network\n# After installation, press Enter to launch 0xlxc manager\n# OR\n# For Access the LXC manager from anywhere just type\n0xlxc\n```\n\n## 📋 Project Structure\n\n| File | Description |\n|------|-------------|\n| `lxc-install.sh` | 🔧 One-click LXC installation with network configuration |\n| `0xlxc.sh` | 🎛️ Advanced interactive container management interface |\n| `VERSION` | 📌 Version control file (current: v1.0.0) |\n| `README.md` | 📚 This comprehensive guide |\n\n## ✨ Key Features\n\n### 🔧 **Installation \u0026 Setup**\n- ✅ **One-click installation** with automated network configuration\n- ✅ **Auto-launch interface** - seamlessly transition from install to management\n- ✅ **Global command access** - use `0xlxc` from anywhere\n- ✅ **Complete uninstallation** with dependency cleanup\n\n### 🎛️ **Container Management**\n- ✅ **Interactive container selection** - no manual typing required\n- ✅ **18 management functions** covering all container operations\n- ✅ **Beautiful table interfaces** with status indicators\n- ✅ **Resource monitoring** - real-time CPU, memory, disk usage\n- ✅ **Container cloning** with interactive source selection\n\n### 💾 **Backup \u0026 Recovery**\n- ✅ **Smart backup system** with automatic file discovery\n- ✅ **Interactive restore** with backup file browser\n- ✅ **Snapshot management** - create, restore, delete snapshots\n- ✅ **Data integrity** - containers stopped during backup for consistency\n\n### 🌐 **Network Management**\n- ✅ **Automatic bridge setup** (lxcbr0 with DHCP)\n- ✅ **Network diagnostics** and connectivity testing\n- ✅ **IP address management** with real-time display\n- ✅ **Network troubleshooting** tools built-in\n\n## 🗺️ Roadmap\n\n### 🔥 **High Priority**\n- [ ]  **Multi-distro Support** - Add support for apt, dnf, zypper package managers\n- [ ]  **Enhanced Resource Editor** - Improve container resource editing functionality\n- [ ]  **Installation Wizard** - GUI-based installation option\n\n### 🚀 **Planned Features**\n- [ ]  **Container Templates** - Pre-configured container templates\n- [ ]  **Logging System** - Persistent logging with rotation\n- [ ]  **Web Interface** - Browser-based management dashboard\n- [ ]  **Auto-scaling** - Dynamic resource adjustment\n- [ ]  **Health Monitoring** - Container health checks and alerts\n- [ ]  **Custom Networks** - Support for custom bridge configurations\n- [ ]  **Container Migration** - Move containers between hosts\n- [ ]  **Backup Scheduling** - Automated backup scheduling\n- [ ]  **Performance Analytics** - Historical performance data\n- [ ]  **Container Orchestration** - Multi-container deployment management\n\n### 🔧 **Technical Improvements**\n- [ ]  **Configuration Files** - YAML/JSON configuration support\n- [ ]  **Container Registry** - Private container image registry\n- [ ]  **Security Hardening** - Enhanced security profiles\n\n## 📋 Complete Function Reference\n\n| # | Function | Description | Features |\n|---|----------|-------------|----------|\n| 1 | **Create Container** | Interactive OS selection | Resource limits, template selection |\n| 2 | **Container Info** | Detailed system information | Resource usage, network details |\n| 3 | **List All Containers** | Overview dashboard | Status, IP addresses, resource usage |\n| 4 | **Start Container** | Boot containers | Interactive selection, status monitoring |\n| 5 | **Stop Container** | Graceful shutdown | Safe stopping with confirmation |\n| 6 | **Restart Container** | Reboot containers | Graceful restart with status updates |\n| 7 | **Delete Container** | Remove containers | Safe deletion with data confirmation |\n| 8 | **Enter Container** | Access container shell | Multiple methods (attach/console) |\n| 9 | **Execute Command** | Run remote commands | Execute in any container remotely |\n| 10 | **Clone Container** | Duplicate containers | Interactive source selection |\n| 11 | **Snapshot Management** | Container snapshots | Create, restore, delete, list |\n| 12 | **Resource Usage** | Real-time monitoring | CPU, memory, disk, network stats |\n| 13 | **Network Configuration** | Network management | Interface config, connectivity tests |\n| 14 | **Backup Container** | Full container backup | Smart directory selection |\n| 15 | **Restore Container** | Restore from backup | Interactive backup file browser |\n| 16 | **Exit** | Quit application | Clean exit with goodbye message |\n| 17 | **Edit Resources** | Modify limits | Dynamic CPU, memory, disk adjustment |\n| 18 | **Uninstall LXC** | Complete removal | Clean uninstall with dependency cleanup |\n\n### 🛠️ **Technical Features**\n- **Cgroup v1/v2 Support** - Automatic detection and compatibility\n- **Resource Validation** - Input validation for all settings\n- **Error Handling** - Comprehensive error checking and user feedback\n- **Color-coded Interface** - Beautiful, intuitive user experience\n- **Table Formatting** - Professional data presentation\n- **Smart Defaults** - Sensible default values for quick setup\n\n## 🎯 Usage Guide\n\n### Basic Usage\n```bash\n# Access the LXC manager from anywhere\n0xlxc\n```\n\n### Command Reference\n```bash\n# Installation\n./lxc-install.sh              # Install LXC with network setup\n\n# Management Interface\n0xlxc                         # Open interactive manager\n\n# Direct LXC Commands (after installation)\nlxc-ls -f                     # List all containers with details\nlxc-start -n CONTAINER_NAME   # Start a specific container\nlxc-stop -n CONTAINER_NAME    # Stop a specific container\nlxc-attach -n CONTAINER_NAME  # Attach to container shell\nlxc-console -n CONTAINER_NAME # Access container console\nlxc-info -n CONTAINER_NAME    # Show container information\n\n# Network Troubleshooting\nsudo lxc-fix-network          # Fix network issues (auto-installed)\n```\n\n### Example Workflow\n```bash\n# 1. Install the system\n./lxc-install.sh\n# Choose option 1, press Enter when done\n\n# 2. Create your first container\n# Select option 1 in 0xlxc interface\n# Choose Ubuntu 22.04, set resources\n\n# 3. Start and enter the container\n# Use options 4 and 8 in the interface\n\n# 4. Backup your configured container\n# Use option 14 for backup\n```\n\n## 🖥️ Distribution Support\n\n### ✅ **Fully Tested \u0026 Supported**\n- **Arch Linux** - Fully tested and working perfectly\n- **CachyOS** - Fully tested and working perfectly\n\n### 📦 **Package Manager Support**\nThe installation script currently supports **pacman** (Arch-based distributions). Support for other package managers is planned:\n\n| Package Manager | Distributions | Status |\n|----------------|---------------|--------|\n| `pacman` | Arch Linux, Manjaro, EndeavourOS, CachyOS | ✅ **Supported** |\n| `apt` | Debian, Ubuntu, Linux Mint, Pop!_OS | 🔄 **Planned** |\n| `dnf` | Fedora, RHEL 8+, CentOS Stream | 🔄 **Planned** |\n| `yum` | RHEL, CentOS 7 | 🔄 **Planned** |\n| `zypper` | openSUSE, SUSE Linux Enterprise | 🔄 **Planned** |\n| `apk` | Alpine Linux | 🔄 **Planned** |\n| `xbps` | Void Linux | 🔄 **Planned** |\n| `emerge` | Gentoo (Portage) | 🔄 **Planned** |\n\n\u003e **Note**: While the core 0xlxc management interface should work on any Linux distribution with LXC installed, the automated installer currently only supports Arch-based systems.\n\n## 📋 Requirements\n\n### System Requirements\n- Linux system with systemd\n- Root/sudo privileges\n- Internet connection for package downloads\n- Minimum 2GB RAM (4GB+ recommended)\n- 10GB+ free disk space\n\n### Dependencies (Auto-installed)\n- LXC (Linux Containers)\n- iptables-nft\n- dnsmasq\n- systemd-networkd\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. Areas where help is needed:\n\n- [ ]  Support for additional package managers (apt, dnf, zypper, etc.)\n- [ ]  Testing on different distributions\n- [ ]  Documentation improvements\n- [ ]  Bug fixes and feature enhancements\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the **[MIT License](https://opensource.org/licenses/MIT)** for details.\n\n## 🐛 Issues \u0026 Support\n\n- **Bug Reports**: [Create an issue](https://github.com/0xamirreza/lxc4dev/issues)\n- **Feature Requests**: [Create an issue](https://github.com/0xamirreza/lxc4dev/issues)\n- **Documentation**: Check this comprehensive README.md for all usage information\n\n## ⭐ Show Your Support\n\nIf this project helped you, please consider giving it a ⭐ on GitHub!\n\n---\n\n**Made with ❤️ for the Linux community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xamirreza%2Flxc4dev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xamirreza%2Flxc4dev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xamirreza%2Flxc4dev/lists"}