{"id":50896078,"url":"https://github.com/mr-addams/antix-docker-install","last_synced_at":"2026-06-16T00:01:57.233Z","repository":{"id":360565309,"uuid":"1128611106","full_name":"mr-addams/antix-docker-install","owner":"mr-addams","description":"Docker installation script for antiX, Devuan, MX Linux and other Debian forks with sysVinit","archived":false,"fork":false,"pushed_at":"2026-06-03T11:47:45.000Z","size":62,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T13:21:28.233Z","etag":null,"topics":["antix-linux","debian","docker","docker-install","installation-script","linux","sysvinit"],"latest_commit_sha":null,"homepage":"https://mr-addams.github.io/antix-docker-install/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mr-addams.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-05T22:39:22.000Z","updated_at":"2026-06-03T11:47:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mr-addams/antix-docker-install","commit_stats":null,"previous_names":["mr-addams/antix-docker-install"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mr-addams/antix-docker-install","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-addams%2Fantix-docker-install","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-addams%2Fantix-docker-install/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-addams%2Fantix-docker-install/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-addams%2Fantix-docker-install/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mr-addams","download_url":"https://codeload.github.com/mr-addams/antix-docker-install/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-addams%2Fantix-docker-install/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34385031,"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-15T02:00:07.085Z","response_time":63,"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":["antix-linux","debian","docker","docker-install","installation-script","linux","sysvinit"],"created_at":"2026-06-16T00:01:57.007Z","updated_at":"2026-06-16T00:01:57.219Z","avatar_url":"https://github.com/mr-addams.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker Installation Script for antiX Linux\n\n![Platform](https://img.shields.io/badge/platform-antiX%20Linux%2023.2-blue)\n![Debian](https://img.shields.io/badge/debian-12%20bookworm-red)\n![License](https://img.shields.io/badge/license-MIT-green)\n![Init System](https://img.shields.io/badge/init-sysVinit%20ONLY-orange)\n![Docker](https://img.shields.io/badge/docker-latest-2496ED?logo=docker)\n![Maintenance](https://img.shields.io/badge/maintained-yes-brightgreen)\n\nComplete Docker installation script for **antiX Linux, Devuan, MX Linux** and other Debian-based systems using **sysVinit**.\n\n## ⚠️ Important: sysVinit Only\n\n**This script is specifically designed for sysVinit-based systems ONLY.**\n\n- ✅ **Works with**: antiX Linux with **sysVinit** init system\n- ❌ **NOT compatible with**: antiX runit version, systemd-based systems\n\nantiX Linux comes in two init system variants:\n- **sysVinit** - ✅ Use this script\n- **runit** - ❌ Do NOT use this script (requires different init configuration)\n\nTo check your init system:\n```bash\nps -p 1 -o comm=\n# Output should be: init (for sysVinit)\n# If output is: runit or systemd - DO NOT use this script\n```\n\n## Overview\n\nThis script performs a complete Docker installation on antiX Linux, which uses sysVinit instead of systemd. It handles all the complexities of Docker installation on non-systemd systems, including proper init script creation and service management.\n\n## Features\n\n- ✅ Complete cleanup of any existing Docker installations\n- ✅ Fresh installation of latest Docker CE with all plugins\n- ✅ Custom init script for sysVinit systems\n- ✅ Automatic service configuration and autostart setup\n- ✅ Docker Compose plugin included\n- ✅ Docker Buildx plugin included\n- ✅ Comprehensive installation verification\n- ✅ User permission configuration\n\n## System Requirements\n\n- antiX Linux 23.2 (based on Debian 12 Bookworm)\n- Root access\n- Internet connection\n- Minimum 512 MB RAM (recommended)\n\n## Compatibility\n\n**This script is ONLY for sysVinit-based systems.**\n\n| Distribution | Init System | Docker Source | Status |\n|---|---|---|---|\n| antiX Linux 23.x | sysVinit | Docker Inc repo (`/usr/bin/dockerd`) | ✅ Tested |\n| Devuan 4/5+ | sysVinit (or fork) | Debian package / self-built (`/usr/sbin/dockerd`) | ✅ Tested (fixes #1) |\n| MX Linux | sysVinit | Docker Inc repo | ✅ Compatible |\n| Debian 12 Bookworm | sysVinit (if configured) | Docker Inc repo | ✅ Compatible |\n| antiX Linux 23.x | **runit** | N/A | ❌ NOT compatible |\n| Any distribution | **systemd** | Docker official method recommended | ❌ NOT compatible |\n\n### How to check your init system:\n\n```bash\n# Check init system\nps -p 1 -o comm=\n\n# Expected output for compatibility:\n# init  ← sysVinit (✅ Compatible)\n\n# If you see these, DO NOT use this script:\n# runit ← runit init system (❌ Not compatible)\n# systemd ← systemd (❌ Not compatible)\n```\n\n**Note for runit users**: This script creates init scripts for `/etc/init.d/` which are sysVinit-specific. For runit-based antiX, you need different service management approach using runit's service directory structure.\n\n## Installation\n\n### Quick Install\n\n```bash\n# Download the script\nwget https://raw.githubusercontent.com/mr-addams/antix-docker-install/main/antix-docker-install.sh\n\n# Make it executable\nchmod +x antix-docker-install.sh\n\n# Run as root\nsudo ./antix-docker-install.sh\n```\n\n### Manual Installation\n\n1. Clone this repository:\n```bash\ngit clone https://github.com/mr-addams/antix-docker-install.git\ncd antix-docker-install\n```\n\n2. Make the script executable:\n```bash\nchmod +x antix-docker-install.sh\n```\n\n3. Run the script as root:\n```bash\nsudo ./antix-docker-install.sh\n```\n\n## What the Script Does\n\n### 1. **Complete Cleanup**\n   - Stops all Docker processes\n   - Removes all existing Docker packages (including old versions)\n   - Unmounts Docker filesystems\n   - Cleans up configuration files and data directories\n   - Removes old repositories and GPG keys\n\n### 2. **Fresh Installation**\n   - Installs required dependencies\n   - Adds official Docker repository\n   - Installs Docker CE and all plugins:\n     - docker-ce\n     - docker-ce-cli\n     - containerd.io\n      - docker-buildx-plugin\n      - docker-compose-plugin\n\n### 3. **System Configuration**\n   - Creates custom init script for sysVinit\n   - Configures Docker daemon settings\n   - Sets up autostart with update-rc.d\n   - Configures user permissions\n\n### 4. **Verification**\n   - Tests init script functionality\n   - Verifies Docker daemon startup\n   - Checks Docker CLI\n   - Tests Docker Compose\n   - Runs hello-world container\n\n## Usage\n\n### Service Management\n\nAfter installation, manage Docker using standard init commands:\n\n```bash\n# Start Docker\nsudo /etc/init.d/docker start\n\n# Stop Docker\nsudo /etc/init.d/docker stop\n\n# Restart Docker\nsudo /etc/init.d/docker restart\n\n# Check status\nsudo /etc/init.d/docker status\n```\n\n### Verification Commands\n\n```bash\n# Check Docker version\ndocker --version\n\n# Check Docker Compose\ndocker compose version\n\n# Run test container\ndocker run hello-world\n\n# List running containers\ndocker ps\n\n# View system info\ndocker info\n```\n\n### User Permissions\n\nThe script automatically adds your user to the `docker` group. To apply group changes:\n\n```bash\n# Log out and log back in\n# OR force group refresh\nnewgrp docker\n```\n\nAfter this, you can run Docker commands without `sudo`.\n\n## Troubleshooting\n\n### Docker won't start\n\n1. Check logs:\n```bash\ncat /var/log/docker.log\n```\n\n2. Check for running processes:\n```bash\nps aux | grep dockerd\n```\n\n3. Verify socket exists:\n```bash\nls -la /var/run/docker.sock\n```\n\n4. Try manual cleanup and restart:\n```bash\nsudo killall -9 dockerd\nsudo rm -f /var/run/docker.sock /var/run/docker.pid\nsudo /etc/init.d/docker start\n```\n\n### Permission denied errors\n\nEnsure your user is in the docker group:\n```bash\ngroups $USER\n```\n\nIf docker group is missing, run:\n```bash\nsudo usermod -aG docker $USER\nnewgrp docker\n```\n\n### \"Device or resource busy\" during cleanup\n\nThe script handles this automatically by unmounting Docker filesystems. If you encounter this manually:\n```bash\nsudo umount $(mount | grep '/var/lib/docker' | awk '{print $3}' | sort -r)\n```\n\n### Container startup issues\n\nCheck system resources:\n```bash\nfree -h\ndf -h\n```\n\nVerify Docker daemon is running:\n```bash\nsudo /etc/init.d/docker status\ndocker info\n```\n\n## Configuration\n\nDocker configuration is stored in `/etc/docker/daemon.json`:\n\n```json\n{\n  \"debug\": false,\n  \"storage-driver\": \"overlay2\",\n  \"exec-opts\": [\"native.cgroupdriver=cgroupfs\"],\n  \"log-driver\": \"json-file\",\n  \"log-opts\": {\n    \"max-size\": \"10m\",\n    \"max-file\": \"3\"\n  }\n}\n```\n\nYou can modify this file and restart Docker to apply changes:\n```bash\nsudo /etc/init.d/docker restart\n```\n\n## Uninstallation\n\nTo completely remove Docker:\n\n```bash\n# Stop Docker\nsudo /etc/init.d/docker stop\n\n# Remove packages\nsudo apt-get remove --purge docker-ce docker-ce-cli containerd.io \\\n  docker-buildx-plugin docker-compose-plugin\n\n# Remove data and configuration\nsudo rm -rf /var/lib/docker\nsudo rm -rf /etc/docker\nsudo rm -f /etc/init.d/docker\nsudo rm -f /var/run/docker.sock\n\n# Remove user from docker group\nsudo deluser $USER docker\n\n# Clean up\nsudo apt-get autoremove\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n### Guidelines\n\n- Test changes on antiX Linux 23.2\n- Maintain compatibility with sysVinit\n- Update README if adding new features\n- Follow existing code style\n\n## Known Issues\n\n- First container startup may be slow due to image downloads\n- Some Docker features requiring systemd may not work\n- **This script will NOT work on antiX runit version** - it requires sysVinit\n\n## License\n\nMIT License\n\nCopyright (c) 2026 antiX Docker Installation Script Contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n## Credits\n\nCreated for the antiX Linux community to simplify Docker installation on non-systemd systems.\n\n## Support\n\n- **Issues**: [Report bugs via GitHub Issues](https://github.com/mr-addams/antix-docker-install/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/mr-addams/antix-docker-install/discussions)\n- **antiX Forum**: https://www.antixforum.com/\n- **Docker Documentation**: https://docs.docker.com/\n\n## Changelog\n\n### Version 1.1.2\n- Auto-detection of Linux distribution (antiX / Devuan / MX Linux / generic Debian) at script start\n- Version number (`$SCRIPT_VERSION`) embedded in script header, shown in title banner\n\n### Version 1.1.1\n- Safe GPG key download: curl no longer piped directly to gpg — downloaded to temp file with verification (exit code + non-empty check)\n\n### Version 1.1.0\n- Cross-distro support: now works on antiX, Devuan, MX Linux and other Debian forks with sysVinit\n- Auto-detection of dockerd path via `command -v` with fallback chain (fixes Devuan compatibility)\n- Removed `docker-model-plugin` from default install (unnecessary AI dependencies on low-resource distros)\n- Added `set -euo pipefail` with proper error handling guards\n- Fixed error message: `docker-full-install.sh` → `antix-docker-install.sh`\n- Fixed shellcheck warnings (SC2046, SC2086)\n- Updated README: compatibility table, removed Docker Model references\n\n### Version 1.0.0\n- Initial release\n- Full Docker CE installation support\n- SysVinit integration\n- Automatic cleanup and verification\n- All official plugins included\n\n---\n\n**Note**: This script is specifically designed for antiX Linux and similar sysVinit-based systems. For systemd-based distributions, use the official Docker installation methods.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr-addams%2Fantix-docker-install","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmr-addams%2Fantix-docker-install","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr-addams%2Fantix-docker-install/lists"}