mirror of
https://github.com/stornic56/debianito-post-install.git
synced 2026-09-14 06:02:35 +00:00
amd gcn legacy support & kernel overhaul
- Fixed Mesa 32-bit dependency conflicts by removing mesa-va-drivers from gaming setup; mesa-libgallium now includes VA-API for Mesa >= 25.3.3, resolving solver errors with backports (Mesa 26.x). - Removed corectrl detection and installation from AMD tools in gpu/amd_intel.sh (retained in System Tools checklist only). - Added zutty terminal emulator option alongside alacritty for Debian 12+ in terminals.sh. - Overhauled Kernel menu: replaced "Backports Kernel" with "Kernel" submenu offering Stable, RT, Cloud, and Backports options; removed hardcoded Debian 11 restriction (backports hidden only on Bullseye); headers now installed automatically with all kernel variants; NVIDIA warnings added for Backports (DKMS required) and RT (driver compatibility note). - Implemented AMD GCN legacy driver migration: is_amd_legacy_gcn() function detects GCN 1.0/1.1 GPUs via whitelist of 85 PCI IDs; offers user prompt to force amdgpu module with GRUB parameters (radeon.si_support=0, radeon.cik_support=0, amdgpu.si_support=1, amdgpu.cik_support=1); safe sed-based injection into GRUB_CMDLINE_LINUX_DEFAULT with backup and idempotency check. - Standardized UI across 27 checklist locations: unified text to "Check [*] the packages you want installed/updated on your system."; removed SCROLL_HINT variable entirely from all code; changed OK button to "Apply" in _checklist() and _inputbox() only (not in _msg/_menu). - Reordered gaming menu checklists: i386 moved to top position, steam/mangohud positioned immediately after for better dependency flow. - Enhanced kernel installation prompts: all variants (Stable, RT, Cloud, Backports) now display candidate version numbers in parentheses using apt-cache policy and madison queries. - update readme
This commit is contained in:
@@ -85,6 +85,136 @@ The submenu offers the next categories:
|
||||
|
||||
---
|
||||
|
||||
## Quick Start — Recommended Setup Order
|
||||
|
||||
This section shows the recommended order to configure a fresh Debian installation for maximum performance and usability. Follow these steps in order — each step builds on the previous one.
|
||||
|
||||
---
|
||||
|
||||
### Step 1 — Know Your System
|
||||
**Menu:** `1 System Information`
|
||||
|
||||
Check your hardware before installing anything. The script detects your CPU, RAM, GPU vendor and generation, network adapters, and display server. Write down what you see — especially the GPU line (Intel/AMD/NVIDIA) and any WiFi chipset. You'll need this info for steps 4 and 5.
|
||||
|
||||
> 💡 If no GPU is detected, you're likely on a VM or headless server — skip step 5.
|
||||
|
||||
---
|
||||
|
||||
### Step 2 — Enable Password Feedback
|
||||
**Menu:** `2 User Privileges & Feedback` → select option for Sudo Password Feedback
|
||||
|
||||
Enable asterisks (`****`) when typing your sudo password. This prevents typos during the many installation steps that follow. Toggle it on now, disable it later if you prefer hidden input.
|
||||
|
||||
---
|
||||
|
||||
### Step 3 — Configure Repositories
|
||||
**Menu:** `3 Configure Repositories`
|
||||
|
||||
This is the foundation — all subsequent installations depend on correct repos.
|
||||
|
||||
1. **Enable Contrib & Non-Free Components** (required for firmware, drivers, Steam)
|
||||
2. **Setup/Update Backports repositories** (recommended — gives you newer kernels, Mesa drivers, and firmware for modern hardware)
|
||||
|
||||
> ⚠️ Without non-free enabled, steps 4 and 5 will fail. Do not skip this.
|
||||
|
||||
---
|
||||
|
||||
### Step 4 — Install Firmware & Wireless Drivers
|
||||
**Menu:** `4 Firmware, Wireless & Bluetooth`
|
||||
|
||||
The script scans ALL network hardware (PCI + USB) and installs exactly the firmware your system needs. Accept the plan it shows — it's based on your actual hardware.
|
||||
|
||||
This step also sets up Bluetooth if your system has Bluetooth hardware (KDE gets bluedevil, XFCE gets blueman, GNOME uses built-in).
|
||||
|
||||
> ⚠️ You need internet for this step. If WiFi isn't working after firmware install, reboot first — the driver needs a fresh load.
|
||||
|
||||
---
|
||||
|
||||
### Step 5 — Install Graphics Drivers
|
||||
**Menu:** `5 Graphics Drivers & Mesa Stack`
|
||||
|
||||
The script auto-detects your GPU and installs the correct driver:
|
||||
|
||||
- **NVIDIA:** The script chooses the best path automatically (CUDA repo, backports, or stable) based on your GPU generation and kernel. Just confirm the plan.
|
||||
- **AMD/Intel:** Installs firmware + Mesa stack + Vulkan drivers. Also installs 32-bit libraries if gaming is planned.
|
||||
- **Hybrid (laptop):** Installs Intel/AMD firmware first, then NVIDIA driver.
|
||||
|
||||
> 💡 After installation, reboot before testing. NVIDIA drivers need a fresh kernel load to activate.
|
||||
|
||||
---
|
||||
|
||||
### Step 6 — Kernel Configuration
|
||||
**Menu:** `6 Kernel`
|
||||
|
||||
If you enabled backports in step 3, you can install a newer kernel (e.g., 7.x) for better hardware support. The script offers stable vs backports:
|
||||
|
||||
| Choice | Best for |
|
||||
|--------|----------|
|
||||
| Stable (default) | Maximum stability, older hardware |
|
||||
| Backports | Modern CPUs (Intel Arrow Lake, AMD Zen 5), new GPUs, better power management |
|
||||
|
||||
> ⚠️ If you installed NVIDIA drivers in step 5, the backports kernel may require DKMS recompilation. The script warns about this — it's usually fine.
|
||||
|
||||
---
|
||||
|
||||
### Step 7 — Gaming Setup (Optional)
|
||||
**Menu:** `7 Gaming Setup`
|
||||
|
||||
If you plan to game on Debian:
|
||||
|
||||
1. **Enable i386 architecture** when prompted — this is REQUIRED for Steam/Proton and 32-bit game libraries
|
||||
2. Select your launchers: Steam, Heroic Games Launcher, Lutris
|
||||
3. Select performance tools: GameMode, MangoHud, GOverlay
|
||||
4. Select RetroArch if you want retro emulation (pre-installed with GBA, SNES, NES, GB cores)
|
||||
|
||||
> ⚠️ Steam requires the contrib repository (step 3) and i386 architecture. The script warns if either is missing.
|
||||
|
||||
---
|
||||
|
||||
### Step 8 — ZRAM Compressed Swap (Optional)
|
||||
**Menu:** `8 ZRAM`
|
||||
|
||||
ZRAM compresses memory pages in RAM instead of writing to disk. This is especially useful on systems with limited RAM (8GB or less). The script automatically sets ZRAM to ~50% of your physical RAM with priority 100 (used before disk swap).
|
||||
|
||||
Choose **LZ4** for gaming (fastest compression) or **ZSTD** for general use (better compression ratio).
|
||||
|
||||
> 💡 If you also use disk-based swap (Option 9), ZRAM is used first. Disk swap only kicks in after ZRAM fills up.
|
||||
|
||||
---
|
||||
|
||||
### Step 9 — Essential Software
|
||||
**Menu:** `10 Install Programs and Software` → option `0 Essential Pack`
|
||||
|
||||
One-click install of the most common tools:
|
||||
|
||||
| Package | What you get |
|
||||
|---------|--------------|
|
||||
| htop, inxi | System monitoring |
|
||||
| neofetch / fastfetch | System info display |
|
||||
| vlc | Media player |
|
||||
| ufw | Firewall|
|
||||
| zip, unrar, p7zip | Compression tools |
|
||||
|
||||
After this, browse the other categories (browsers, editors, dev tools) as needed.
|
||||
|
||||
---
|
||||
|
||||
### Complete Flow Summary
|
||||
|
||||
1. System Information ← Know your hardware
|
||||
2. User Privileges & Feedback ← Enable password asterisks
|
||||
3. Configure Repositories ← Enable contrib + non-free + backports
|
||||
4. Firmware, Wireless & Bluetooth ← Install WiFi/BT firmware
|
||||
5. Graphics Drivers & Mesa Stack ← Install GPU drivers
|
||||
6. Kernel ← Optional: newer kernel (Backports)
|
||||
7. Gaming Setup ← Optional: Steam + tools
|
||||
8. ZRAM ← Optional: compressed swap
|
||||
9. Install Programs → 0 Essential ← Common tools
|
||||
|
||||
**Estimated time:** 15-20 minutes for a full setup (steps 1-5 + 9). Steps 6-8 are optional and depend on your use case.
|
||||
|
||||
|
||||
---
|
||||
## File Structure
|
||||
|
||||
| Directory/File | Description |
|
||||
@@ -101,12 +231,15 @@ The submenu offers the next categories:
|
||||
```bash
|
||||
├── debianito.sh
|
||||
├── docs
|
||||
│ ├── boot.md
|
||||
│ ├── desktops_display.md
|
||||
│ ├── firmware.md
|
||||
│ ├── gaming.md
|
||||
│ ├── gpu.md
|
||||
│ ├── kernel.md
|
||||
│ ├── repos_config.md
|
||||
│ ├── retroarch.md
|
||||
│ ├── swap.md
|
||||
│ ├── system_info.md
|
||||
│ ├── user_priv_feed.md
|
||||
│ └── zram.md
|
||||
@@ -121,6 +254,8 @@ The submenu offers the next categories:
|
||||
│ │ └── repos.sh
|
||||
│ ├── desktop_display.sh
|
||||
│ ├── extras
|
||||
│ │ ├── communication
|
||||
│ │ │ └── communication.sh
|
||||
│ │ ├── design
|
||||
│ │ │ └── design.sh
|
||||
│ │ ├── dev
|
||||
@@ -147,6 +282,8 @@ The submenu offers the next categories:
|
||||
│ │ ├── system
|
||||
│ │ │ ├── software_centers.sh
|
||||
│ │ │ └── system.sh
|
||||
│ │ ├── terminals
|
||||
│ │ │ └── terminals.sh
|
||||
│ │ └── themes
|
||||
│ │ ├── cursors
|
||||
│ │ │ └── cursors.sh
|
||||
|
||||
Reference in New Issue
Block a user