/debian

Installation and post-installation scripts for Debian.

Primary LanguageShellGNU General Public License v2.0GPL-2.0

Debian Installation

This is a set of scripts installing Debian and running post-installation tasks, e.g. installing a desktop environment, packages, and config files. They are intended for Cinnamon, GNOME, and KDE.

Note: While the post-installation scripts could be used for Ubuntu, some packages have different names than their counterparts in the Debian repositories, so this script may not work for all packages.

Requirements:

  1. curl
  2. fzf
  3. git
  4. sudo

Install

The install script will install Debian on a user-prompted block device. Supports installations on hardware using UEFI or legacy BIOS and will set a GPT partition table and ext4 filesystem. Other features, such as bootloader or encryption, are set when prompted.

The OS can be configured for LVM-on-LUKS full-disk encryption or not. Using GRUB will also encrypt the /boot directory and write a decryption key into the initial ramdisk so that the password prompt only appears once. For alternate bootloaders, the boot directory will remain unencrypted.

There is also the optional provision for creating a separate, unencrypted partition of arbitrary size. Useful for creating shared filesystems readable on Windows / MacOS for USB drive installations.

The rough partition scheme is:

1. BIOS compatibility partition, empty if GRUB not used (1 MiB)
2. EFI partition (512 MiB)
3. Share partition (optional)
4. Debian system (Plain / LVM / LUKS-encrypted partitions or volumes)
   - swap
   - root
   - home (optional)

Note: The script uses sgdisk for partitioning, which uses binary (base 2) units for specifying partition sizes. For example, 500M corresponds to 500 mebibytes, not 500 megabytes.

To run, (need to be root):

sudo ./install

Options

Installation options will be queries as the script runs.

Partitioning

1) Back
2) LVM on LUKS
3) LVM
4) Plain
  1. Installs on LUKS-encrypted partition. Partitions (e.g. root and home) are kept as logical volumes on the LUKS partition.
  2. Installs on unencrypted LVM partition.
  3. Installs everything on primary partitions.

Boot system

1) Back
2) GRUB
3) systemd-boot
4) EFISTUB
  1. Installs GRUB, BIOS version if no EFI firmware is detected. Otherwise, the EFI version is installed.
  2. systemd-boot (previously gummiboot) installs kernels in /boot and copies them over to /efi. SystemD path hooks are also installed to update kernel images and microcode in /efi after updates.
  3. Not supported yet...

Etc.

The script will also prompt for:

  1. Host name
  2. User name
  3. User password
  4. (Optional) LUKS password
  5. Locale (e.g. en_US.UTF-8)
  6. Time zone (e.g. America/Toronto)

The script will then mount the partitions, set up chroot, download and install all the base and base-devel packages via debootstrap, set up the specified user account, lock the root account, and unmount everything.

Post-install

Once the base system is installed, use the ./postinstall script (as the user account, not root), to install the remaining packages, themes, etc.

Simply run:

./postinstall

The script will check if the dependencies are installed and if the network connection is active. The rest should be self explanatory.

Options

1) Quit                 4) Miscellaneous        7) Applications
2) Autopilot            5) Desktop environment  8) Themes
3) Base                 6) Network tools        9) Personalization

2) Autopilot

Automatically install (without prompting) packages and configs.

3) Base

1) Back                   5) Firmware             9) Enable non-free-firmware
2) All                    6) Updates              10) Upgrade Debian release
3) Base packages          7) Enable contrib       11) Sudo insults
4) Purge packages         8) Enable non-free      12) Disable system beep

  1. Installs base.list.

  2. Purge packages in purge.list that are unneeded but installed by default.

  3. Install firmware packages for wireless cards and kernel modules.

  4. Updates system packages.

  5. Enable the contrib package repository.

  6. Enable the non-free package repository.

  7. Enable the non-free-firmware package repository.

  8. Upgrade the Debian release (e.g., Buster -> Bullseye).

  9. Enable sudo insults for incorrect login attempts via /etc/sudoers. Pipes to visudo via tee, so it's safe.

  10. Blacklist pcskpr and snd_pcsp kernel modules.

4) Miscellaneous

1) Back        3) Linux utilities  5) Plymouth         7) zsh
2) All         4) Laptop tools     6) SELinux

  1. Install general command line utilities in utils.list.

  2. Install tlp for power management and xorg-xbacklight for screen brightness.

  3. Install Plymouth splash screen.

  4. Install and activate SELinux.

  5. Install zsh, fish-like plugins, nerd fonts, and powerlevel10k theme.

5) Desktop environment

1) Back
2) All
3) GNOME
4) Cinnamon
5) KDE

  1. Install GNOME desktop environment (with GDM for login).

  2. Install Cinnamon desktop environment and Gammastep (with LightDM for login).

  3. Install KDE desktop environment (with SDDM for login).

6) Network tools

1) Back                 4) Local discovery      7) Tunnel apt over tor
2) All                  5) Firewall
3) Networking           6) Install tor

  1. Install Network Manager and OpenSSH. Sets NetworkManager to use random MAC addresses for network interfaces.

  2. Install Avahi and Samba and enable tools for local network hosting and discovery.

  3. Install UFW for network firewall and set up basic rules.

  4. Install tor and torsocks (no Tor Browser).

  5. EXPERIMENTAL Tunnel all package updates through Tor.

7) Applications

1) Back                       10) Extra applications       19) PipeWire
2) All                        11) Extra KDE applications   20) TeX Live
3) 3D acceleration            12) Emulators                21) Tor browser
4) Android tools              13) KVM (host)               22) Vim
5) General applications       14) KVM (guest)              23) Neovim
6) General KDE applications   15) Messaging                24) LazyVim (Neovim)
7) Codecs                     16) MinGW                    25) VirtualBox (host)
8) Containers                 17) Music                    26) VirtualBox (guest)
9) Development                18) Printing                 27) Wine

  1. Install 3D video acceleration packages in 3d-accel.list.

  2. Install packages in android.list for accessing storage on Android devices.

  3. Install general GTK applications from apps.list.

  4. Install general KDE (Qt) applications from apps-kde.list.

  5. Install GStreamer plugins for handing various media codecs.

  6. Install container packages (conatinerd, LXC, Nomad, Podman).

  7. Install packages for programming and software development.

  8. Install extra, less used applications from extra.list.

  9. Install extra KDE (Qt) applications from extra-kde.list.

  10. Install game system emulators.

  11. Install Virt-Manager and tools for using KVM virtualization.

  12. Install packages for Linux guests to enable host-to-guest sharing and adjustable display resolution.

  13. Install IRC, email, and other messaging clients.

  14. Install MinGW for Windows/Linux cross-platform compilation.

  15. Install applications for playing music (mpd, ncmcpp, clementine), computing replaygain (ffmpeg), tagging metadata (beets), and using Pandora (pianobar).

  16. Install CUPS, drivers, and applications for handling printers.

  17. Install PipeWire for A/V handling (replaces PulseAudio, ALSA, etc.).

  18. Install TeX libraries and Font Awesome icons.

  19. Download and install the Tor browser. Edits the application launcher icon to look for "browser-tor".

  20. Install vim and vim-plugins and then set the user vimrc.

  21. Install neovim and then set the user init.vim.

  22. Install LazyVim for Neovim and its dependencies.

  23. Install VirtualBox and kernel modules (dkms) for running it (host).

  24. Install kernel modules (dkms) and tools for VirtualBox guests.

  25. Install Wine not-emulator, along with the Mono and browser and some audio libraries.

8) Themes

1) Back                           8) Materia (KDE)
2) All                            9) Fonts
3) Arc (GTK)                     10) Papirus (icons)
4) Arc (KDE)                     11) Colorific themes
5) Adapta (GTK)                  12) Nightfox themes
6) Plata (GTK)                   13) Timed backgrounds
7) Materia (GTK)                 14) Dynamic wallpapers (Plasma)

  1. Download, compile, and install a fork of the Arc GTK theme.

  2. Download, compile, and install a fork of the Arc Kvantum theme.

  3. Download, compile, and install a fork of the Adapta GTK theme.

  4. Download, compile, and install a fork of the Plata GTK theme.

  5. Download, compile, and install a fork of the Materia GTK theme.

  6. Download, compile, and install a fork of the Materia Kvantum theme.

  7. Install Noto, Cantarell, Ubuntu, Dejavu, and Roboto fonts.

  8. Install tweaked version of Papirus icon theme.

  9. Install colorific themes for alacritty, gitk, kitty, Neovim, tmux, and Vim.

  10. Install Nightfox themes for alacritty, kitty, Neovim, and tmux.

  11. Install timed backgrounds where transitions from day to night match sunrise/sunset times.

  12. Install timed backgrounds for Plasma where transitions from day to night match sunrise/sunset times.

9) Personalization

 1) Back                            11) Import KDE settings
 2) All                             12) Import application dconf
 3) Select system fonts             13) Import GNOME terminal profiles
 4) Select icon theme               14) Enable autologin
 5) Select GTK theme                15) Invert brightness (i915)
 6) Select Plasma theme             16) Enable IOMMU (Intel)
 7) Set dark GTK                    17) Disable PulseAudio suspend
 8) Select login shell              18) Disable 802.11n
 9) Import Cinnamon dconf           19) Add scripts
10) Import GNOME dconf


 1) Back                            11) Import GNOME dconf
 2) All                             12) Import KDE settings
 3) Select system fonts             13) Import application dconf
 4) Select icon theme               14) Import GNOME terminal profiles
 5) Select GTK theme                15) Enable autologin
 6) Select Plasma theme             16) Invert brightness (i915)
 7) Select Plymouth theme           17) Enable IOMMU (Intel)
 8) Set dark GTK                    18) Disable PulseAudio suspend
 9) Select login shell              19) Disable 802.11n
10) Import Cinnamon dconf           20) Add scripts

  1. Select the system font. (Noto or Roboto)

  2. Select the system icon theme.

  3. Select the system desktop theme (GTK).

  4. Select the system desktop theme (Plasma).

  5. Select the Plymouth splash screen theme.

  6. Set GTK applications to prefer the dark theme.

  7. Select default login shell (Bash or Zsh).

  8. Import pre-defined dconf settings for Cinnamon.

  9. Import pre-defined dconf settings for GNOME.

  10. Configure default desktop and application settings for Plasma.

  11. Import pre-defined dconf settings for applications.

  12. Import GNOME-terminal profiles (Light/Dark) via dconf.

  13. Enable autologin for the current user.

  14. Invert brightness via kernel command line options in the GRUB prompt.

  15. Enable Intel IOMMU for the i915 graphics driver. Helps fix blank displays for Haswell CPUs running kernels >=5.7.

  16. Disable PulseAudio suspend (suspend can sometimes cause weird buzzing).

  17. Disable 802.11n networking in iwlwifi. May help speed up poor 802.11ac connections.

  18. Download and install general utility scripts.