Skip to content

README.md

Latest commit

 

History

History
361 lines (262 loc) · 9.79 KB

README.md

File metadata and controls

361 lines (262 loc) · 9.79 KB

🚀 Universal Linux Installer

A universal and optimized installation script for Linux distributions, supporting a wide range of distribution families with automatic detection.

Version en français dans LISEZMOI.md

✨ Features

  • 🔍 Automatic detection of Linux distribution
  • 📦 Multi-distribution support with specialized scripts
  • 🎯 Modular installation with interactive package selection
  • 🛠️ Optimized configuration for each package manager
  • 📊 Progress bars and detailed logging
  • 🔧 Complete development environment
  • 🐚 ZSH configuration with Oh My Zsh
  • 📝 Complete logging for debugging
  • 🧹 Automatic system cleanup

🏗️ Project Structure

├── install.sh                    # Main script with auto detection
├── common/
│   └── functions.sh              # Shared common functions
└── distributions/
    ├── debian/
    │   └── install.sh           # Ubuntu, Debian, Mint, Elementary, Pop!_OS, Kali
    ├── arch/
    │   └── install.sh           # Arch, Manjaro, EndeavourOS, ArcoLinux, Garuda
    ├── redhat/
    │   └── install.sh           # Fedora, Nobara, CentOS, RHEL, Rocky, AlmaLinux, OpenSUSE
    ├── gentoo/
    │   └── install.sh           # Gentoo Linux
    ├── alpine/
    │   └── install.sh           # Alpine Linux
    ├── void/
    │   └── install.sh           # Void Linux
    └── nixos/
        └── install.sh           # NixOS

🐧 Supported Distributions

Debian Family

  • Ubuntu (all versions)
  • Debian (stable, testing, unstable)
  • Linux Mint
  • Elementary OS
  • Pop!_OS
  • Kali Linux
  • Parrot Security OS

Arch Family

  • Arch Linux
  • Manjaro
  • EndeavourOS
  • ArcoLinux
  • Garuda Linux
  • Artix Linux

Red Hat Family

  • Fedora
  • Nobara Linux
  • CentOS
  • Red Hat Enterprise Linux (RHEL)
  • Rocky Linux
  • AlmaLinux
  • OpenSUSE

Other Distributions

  • Gentoo Linux - Source-based compilation
  • Alpine Linux - Lightweight musl-based distribution
  • Void Linux - Rolling release with runit
  • NixOS - Declarative configuration

🚀 Quick Installation

Simple Usage

# Clone the repository
git clone https://github.com/N0tFond/Script.git
cd Script

# Make the script executable
chmod +x install.sh

# Run the installation (script automatically detects your distribution)
./install.sh

Specific Installation

If you want to force a specific distribution:

# For Ubuntu/Debian
./distributions/debian/install.sh ubuntu

# For Arch Linux
./distributions/arch/install.sh arch

# For Fedora
./distributions/redhat/install.sh fedora

⚠️ Critical Warnings

Important

Distribution not detected: If the script fails to identify your Linux distribution, the installation will terminate immediately with an error code.

� Detection Problem Resolution

Warning

Automatic detection failure can occur on custom or very recent distributions.

Recommended solutions:

  1. Compatibility verification

    # Check your distribution
cat /etc/os-release

  2. Forced installation for compatible distributions

    # Debian-based distribution (Ubuntu, Mint, Elementary, etc.)
./distributions/debian/install.sh ubuntu

# Arch-based distribution (Manjaro, EndeavourOS, etc.)
./distributions/arch/install.sh arch

# Red Hat-based distribution (Fedora, CentOS, etc.)
./distributions/redhat/install.sh fedora

  3. Technical support

Note

Create a GitHub issue with the following information:

  • Output of cat /etc/os-release
  • Kernel version (uname -r)
  • Complete error messages

🛡️ Security Recommendations

Caution

Mandatory testing: Always test on a virtual machine before production deployment.

  • Complete backup of critical data
  • System restore point if available
  • Sudo privileges verification before execution
  • Stable internet connection required during installation

Tip

Debug mode: Add bash -x for detailed diagnostics

bash -x ./install.sh

📦 Installed Packages

Base Packages

  • System tools: git, curl, wget, htop, tree, unzip
  • Shell: zsh with Oh My Zsh
  • System information: neofetch

Development Tools

  • Node.js via NVM (version 22)
  • Python 3 with pip
  • Compilers: gcc, make, build-essential
  • Git with interactive configuration

Applications

  • Editor: Visual Studio Code
  • Browsers: Firefox, Chrome
  • Media: VLC
  • Communication: Discord
  • Productivity: LibreOffice
  • Graphics: GIMP

Alternative Package Managers

  • Flatpak with Flathub
  • Snap (Ubuntu)
  • AUR helpers (Arch - yay)

🔧 Features by Distribution

Debian/Ubuntu

  • Official and third-party repository configuration
  • PPA and external repository support
  • Installation via APT, Flatpak and Snap

Arch Linux

  • Optimized Pacman configuration
  • AUR helper installation (yay)
  • Service management with systemd
  • Automatic cleanup of orphaned packages

Fedora/RHEL

  • RPM Fusion configuration
  • EPEL repository management
  • SELinux support
  • Firewalld configuration

Gentoo

  • Portage optimization (MAKEOPTS, USE flags)
  • Overlay management with Layman
  • OpenRC services
  • Optimized parallel compilation

Alpine

  • Glibc compatibility for applications
  • Lightweight package management
  • OpenRC services
  • Musl libc optimizations

Void Linux

  • Optimized XBPS configuration
  • Runit services
  • Multilib and non-free repositories
  • Intelligent cache management

NixOS

  • Declarative configuration
  • Home-manager setup
  • Flakes support
  • Automatic garbage collection

⚙️ Configuration Options

The script offers several levels of customization:

Interactive Installation

  • Package category selection
  • Individual application choices
  • System service configuration
  • Distribution-specific optimizations

Automated Configuration

  • Pre-defined environment variables
  • Default configuration scripts
  • Automatic post-installation cleanup

📝 Logging and Debugging

  • Log file: installation.log in the script directory
  • Color codes for better readability
  • Complete error handling with rollback
  • Progress bars for long operations

🛡️ Security

  • Privilege verification: The script refuses to run as root
  • User input validation
  • Repository signature verification
  • Automatic backup of system configurations

🚨 Prerequisites

  • Active internet connection
  • Sudo privileges for the user
  • Bash 4.0+ minimum
  • Supported Linux distribution

🤝 Contributing

Contributions are welcome! Here's how to contribute:

  1. Fork the project
  2. Create a feature branch (git checkout -b feature/new-distribution)
  3. Commit your changes (git commit -m 'Add support for XYZ')
  4. Push to the branch (git push origin feature/new-distribution)
  5. Create a Pull Request

Adding a New Distribution

  1. Create a folder in distributions/family-name/
  2. Create an install.sh script based on existing templates
  3. Add detection in the main script
  4. Test on the target distribution

📄 License

This project is licensed under MIT. See the LICENSE file for more details.

Author

@notfound

🔄 Changelog

Version 3.0 (October 2025)

  • 🔒 Complete security audit with detailed report and enhanced configuration
  • 🛡️ Security scripts: security-audit.sh for automated system checks
  • 📋 Improved detection tests with test-detection.sh for multi-distribution validation
  • 🔄 Migration script migrate.sh for smooth version updates
  • 📚 Multilingual documentation with English README (EN_README.md)
  • 🔧 Centralized security configuration via security.conf
  • 🧪 Automated testing to ensure cross-distribution compatibility
  • 🔍 Vulnerability detection and security recommendations
  • 📊 Performance metrics and installation monitoring
  • 🛠️ Optimized common functions in common/functions.sh

Version 2.0 (September 2024)

  • ✨ Complete refactoring with modular architecture
  • 🚀 Support for 7 Linux distribution families
  • 📊 Improved user interface with progress bars
  • 🔧 Optimized configuration per distribution
  • 📝 Advanced logging and error handling
  • 🧹 Intelligent automatic cleanup
  • 🎯 Modular and interactive installation

Version 1.0 (May 2024)

  • 🎉 Initial version for Arch and Debian
  • 📦 Basic installation with some applications
  • 🐚 Basic ZSH configuration

⚠️ Warnings

  • Always test on a virtual machine before production use
  • Backup your important data before installation
  • Read logs in case of errors to diagnose problems
  • Verify compatibility with your specific distribution version

🆘 Support

In case of problems:

  1. Check the installation.log file
  2. Review existing GitHub issues
  3. Create a new issue with the error log
  4. Specify your exact distribution and version

⭐ Don't hesitate to star the project if it was useful to you!