{"id":21639360,"url":"https://github.com/sudorook/debian","last_synced_at":"2025-10-03T20:09:36.514Z","repository":{"id":54469132,"uuid":"105379808","full_name":"sudorook/debian","owner":"sudorook","description":"Installation and post-installation scripts for Debian.","archived":false,"fork":false,"pushed_at":"2024-12-16T01:57:54.000Z","size":693,"stargazers_count":55,"open_issues_count":0,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-31T11:12:32.308Z","etag":null,"topics":["debian","debian-installer","dotfiles"],"latest_commit_sha":null,"homepage":"","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/sudorook.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSES/GPL-2.0-only.txt","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}},"created_at":"2017-09-30T15:33:30.000Z","updated_at":"2025-01-11T22:31:03.000Z","dependencies_parsed_at":"2023-02-16T17:15:42.841Z","dependency_job_id":"8f66064e-0ce6-48cb-8acb-f4c527a35c9c","html_url":"https://github.com/sudorook/debian","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudorook%2Fdebian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudorook%2Fdebian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudorook%2Fdebian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudorook%2Fdebian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sudorook","download_url":"https://codeload.github.com/sudorook/debian/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238053518,"owners_count":19408705,"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","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":["debian","debian-installer","dotfiles"],"created_at":"2024-11-25T04:13:35.008Z","updated_at":"2025-10-03T20:09:31.464Z","avatar_url":"https://github.com/sudorook.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Debian Installation\n\nThis is a set of scripts installing Debian and running post-installation tasks,\ne.g. installing a desktop environment, packages, and config files. They are\nintended for Cinnamon, GNOME, and KDE.\n\n**Note:** While the post-installation scripts could be used for Ubuntu, some\npackages have different names than their counterparts in the Debian\nrepositories, so this script may not work for all packages.\n\nRequirements:\n\n1. `curl`\n2. `fzf`\n3. `git`\n4. `sudo`\n\n## Install\n\nThe `install` script will install Debian on a user-prompted block device.\nSupports installations on hardware using UEFI or legacy BIOS and will set a GPT\npartition table and ext4 filesystem. Other features, such as bootloader or\nencryption, are set when prompted.\n\nThe OS can be configured for LVM-on-LUKS full-disk encryption or not. Using GRUB\nwill also encrypt the `/boot` directory and write a decryption key into the\ninitial ramdisk so that the password prompt only appears once. For alternate\nbootloaders, the `boot` directory will remain unencrypted.\n\nThere is also the optional provision for creating a separate, unencrypted\npartition of arbitrary size. Useful for creating shared filesystems readable on\nWindows / MacOS for USB drive installations.\n\nThe rough partition scheme is:\n\n```\n1. BIOS compatibility partition, empty if GRUB not used (1 MiB)\n2. EFI partition (512 MiB)\n3. Share partition (optional)\n4. Debian system (Plain / LVM / LUKS-encrypted partitions or volumes)\n   - swap\n   - root\n   - home (optional)\n```\n\n**Note:** The script uses `sgdisk` for partitioning, which uses binary (base 2)\nunits for specifying partition sizes. For example, 500M corresponds to 500\nmebibytes, not 500 megabytes.\n\nTo run, (need to be root):\n\n```sh\nsudo ./install\n```\n\n### Options\n\nInstallation options will be queries as the script runs.\n\n#### Partitioning\n\n```\n1) Back\n2) LVM on LUKS\n3) LVM\n4) Plain\n```\n\n2. Installs on LUKS-encrypted partition. Partitions (e.g. root and home) are\n   kept as logical volumes on the LUKS partition.\n3. Installs on unencrypted LVM partition.\n4. Installs everything on primary partitions.\n\n#### Boot system\n\n```\n1) Back\n2) GRUB\n3) systemd-boot\n4) EFISTUB\n```\n\n2. Installs GRUB, BIOS version if no EFI firmware is detected. Otherwise, the\n   EFI version is installed.\n3. systemd-boot (previously gummiboot) installs kernels in `/boot` and copies\n   them over to `/efi`. SystemD path hooks are also installed to update kernel\n   images and microcode in `/efi` after updates.\n4. Not supported yet...\n\n#### Etc.\n\nThe script will also prompt for:\n\n1. Host name\n2. User name\n3. User password\n4. (Optional) LUKS password\n5. Locale (e.g. `en_US.UTF-8`)\n6. Time zone (e.g. `America/Toronto`)\n\nThe script will then mount the partitions, set up chroot, download and install\nall the `base` and `base-devel` packages via `debootstrap`, set up the specified\nuser account, lock the root account, and unmount everything.\n\n## Post-install\n\nOnce the base system is installed, use the `./postinstall` script (as the user\naccount, not root), to install the remaining packages, themes, etc.\n\nSimply run:\n\n```sh\n./postinstall\n```\n\nThe script will check if the dependencies are installed and if the network\nconnection is active. The rest should be self explanatory.\n\n### Options\n\n```\n1) Quit                 4) Miscellaneous        7) Applications\n2) Autopilot            5) Desktop environment  8) Themes\n3) Base                 6) Network tools        9) Personalization\n```\n\n#### 2) Autopilot\n\nAutomatically install (without prompting) packages and configs.\n\n#### 3) Base\n\n```\n1) Back                   5) Firmware             9) Enable non-free-firmware\n2) All                    6) Updates              10) Upgrade Debian release\n3) Base packages          7) Enable contrib       11) Sudo insults\n4) Purge packages         8) Enable non-free      12) Disable system beep\n```\n\n3. Installs [base.list](packages/base.list).\n\n4. Purge packages in [purge.list](packages/purge.list) that are unneeded but\n   installed by default.\n\n5. Install firmware packages for wireless cards and kernel modules.\n\n6. Updates system packages.\n\n7. Enable the `contrib` package repository.\n\n8. Enable the `non-free` package repository.\n\n9. Enable the `non-free-firmware` package repository.\n\n10. Upgrade the Debian release (e.g., Buster -\u003e Bullseye).\n\n11. Enable sudo insults for incorrect login attempts via `/etc/sudoers`. Pipes\n    to `visudo` via `tee`, so it's safe.\n\n12. Blacklist `pcskpr` and `snd_pcsp` kernel modules.\n\n#### 4) Miscellaneous\n\n```\n1) Back        3) Linux utilities  5) Plymouth         7) zsh\n2) All         4) Laptop tools     6) SELinux\n```\n\n3. Install general command line utilities in [utils.list](packages/utils.list).\n\n4. Install `tlp` for power management and `xorg-xbacklight` for screen\n   brightness.\n\n5. Install Plymouth splash screen.\n\n6. Install and activate SELinux.\n\n7. Install `zsh`, fish-like plugins, nerd fonts, and powerlevel10k theme.\n\n#### 5) Desktop environment\n\n```\n1) Back\n2) All\n3) GNOME\n4) Cinnamon\n5) KDE\n```\n\n3. Install GNOME desktop environment (with GDM for login).\n\n4. Install Cinnamon desktop environment and Gammastep (with LightDM for login).\n\n5. Install KDE desktop environment (with SDDM for login).\n\n#### 6) Network tools\n\n```\n1) Back                 4) Local discovery      7) Tunnel apt over tor\n2) All                  5) Firewall\n3) Networking           6) Install tor\n```\n\n3. Install Network Manager and OpenSSH. Sets NetworkManager to use random MAC\n   addresses for network interfaces.\n\n4. Install Avahi and Samba and enable tools for local network hosting and\n   discovery.\n\n5. Install UFW for network firewall and set up basic rules.\n\n6. Install `tor` and `torsocks` (no Tor Browser).\n\n7. **EXPERIMENTAL** Tunnel all package updates through Tor.\n\n#### 7) Applications\n\n```\n1) Back                       10) Extra applications       19) PipeWire\n2) All                        11) Extra KDE applications   20) TeX Live\n3) 3D acceleration            12) Emulators                21) Tor browser\n4) Android tools              13) KVM (host)               22) Vim\n5) General applications       14) KVM (guest)              23) Neovim\n6) General KDE applications   15) Messaging                24) LazyVim (Neovim)\n7) Codecs                     16) MinGW                    25) VirtualBox (host)\n8) Containers                 17) Music                    26) VirtualBox (guest)\n9) Development                18) Printing                 27) Wine\n```\n\n3. Install 3D video acceleration packages in\n   [3d-accel.list](packages/3d-accel.list).\n\n4. Install packages in [android.list](packages/android.list) for accessing\n   storage on Android devices.\n\n5. Install general GTK applications from [apps.list](packages/apps.list).\n\n6. Install general KDE (Qt) applications from\n   [apps-kde.list](packages/apps-kde.list).\n\n7. Install GStreamer plugins for handing various media codecs.\n\n8. Install container packages (conatinerd, LXC, Nomad, Podman).\n\n9. Install packages for programming and software development.\n\n10. Install extra, less used applications from\n    [extra.list](packages/extra.list).\n\n11. Install extra KDE (Qt) applications from\n    [extra-kde.list](packages/extra-kde.list).\n\n12. Install game system emulators.\n\n13. Install Virt-Manager and tools for using KVM virtualization.\n\n14. Install packages for Linux guests to enable host-to-guest sharing and\n    adjustable display resolution.\n\n15. Install IRC, email, and other messaging clients.\n\n16. Install MinGW for Windows/Linux cross-platform compilation.\n\n17. Install applications for playing music (`mpd`, `ncmcpp`, `clementine`),\n    computing replaygain (`ffmpeg`), tagging metadata (`beets`), and using\n    Pandora (`pianobar`).\n\n18. Install CUPS, drivers, and applications for handling printers.\n\n19. Install PipeWire for A/V handling (replaces PulseAudio, ALSA, etc.).\n\n20. Install TeX libraries and Font Awesome icons.\n\n21. Download and install the Tor browser. Edits the application launcher icon to\n    look for \"browser-tor\".\n\n22. Install `vim` and `vim-plugins` and then set the user vimrc.\n\n23. Install `neovim` and then set the user init.vim.\n\n24. Install LazyVim for Neovim and its dependencies.\n\n25. Install VirtualBox and kernel modules (dkms) for running it (host).\n\n26. Install kernel modules (dkms) and tools for VirtualBox guests.\n\n27. Install Wine not-emulator, along with the Mono and browser and some audio\n    libraries.\n\n#### 8) Themes\n\n```\n1) Back                           8) Materia (KDE)\n2) All                            9) Fonts\n3) Arc (GTK)                     10) Papirus (icons)\n4) Arc (KDE)                     11) Colorific themes\n5) Adapta (GTK)                  12) Nightfox themes\n6) Plata (GTK)                   13) Timed backgrounds\n7) Materia (GTK)                 14) Dynamic wallpapers (Plasma)\n```\n\n3. Download, compile, and install a\n   [fork](https://github.com/sudorook/arc-theme) of the\n   [Arc GTK theme](https://github.com/horst3180/arc-theme).\n\n4. Download, compile, and install a [fork](https://github.com/sudorook/arc-kde)\n   of the\n   [Arc Kvantum theme](https://github.com/PapirusDevelopmentTeam/arc-kde).\n\n5. Download, compile, and install a\n   [fork](https://github.com/sudorook/adapta-gtk-theme) of the\n   [Adapta GTK theme](https://github.com/adapta-project/adapta-gtk-theme).\n\n6. Download, compile, and install a\n   [fork](https://gitlab.com/sudorook/plata-theme) of the\n   [Plata GTK theme](https://gitlab.com/tista500/plata-theme).\n\n7. Download, compile, and install a\n   [fork](https://github.com/sudorook/materia-theme) of the\n   [Materia GTK theme](https://github.com/nana-4/materia-theme).\n\n8. Download, compile, and install a\n   [fork](https://github.com/sudorook/materia-kde) of the\n   [Materia Kvantum theme](https://github.com/PapirusDevelopmentTeam/materia-kde).\n\n9. Install Noto, Cantarell, Ubuntu, Dejavu, and Roboto fonts.\n\n10. Install tweaked version of Papirus icon theme.\n\n11. Install [colorific themes](https://github.com/sudorook/colorific.vim) for\n    alacritty, gitk, kitty, Neovim, tmux, and Vim.\n\n12. Install [Nightfox themes](https://github.com/sudorook/nightfox.nvim) for\n    alacritty, kitty, Neovim, and tmux.\n\n13. Install [timed backgrounds](https://github.com/sudorook/timed-backgrounds)\n    where transitions from day to night match sunrise/sunset times.\n\n14. Install\n    [timed backgrounds](https://github.com/sudorook/plasma5-timed-backgrounds)\n    for Plasma where transitions from day to night match sunrise/sunset times.\n\n#### 9) Personalization\n\n```\n 1) Back                            11) Import KDE settings\n 2) All                             12) Import application dconf\n 3) Select system fonts             13) Import GNOME terminal profiles\n 4) Select icon theme               14) Enable autologin\n 5) Select GTK theme                15) Invert brightness (i915)\n 6) Select Plasma theme             16) Enable IOMMU (Intel)\n 7) Set dark GTK                    17) Disable PulseAudio suspend\n 8) Select login shell              18) Disable 802.11n\n 9) Import Cinnamon dconf           19) Add scripts\n10) Import GNOME dconf\n\n\n 1) Back                            11) Import GNOME dconf\n 2) All                             12) Import KDE settings\n 3) Select system fonts             13) Import application dconf\n 4) Select icon theme               14) Import GNOME terminal profiles\n 5) Select GTK theme                15) Enable autologin\n 6) Select Plasma theme             16) Invert brightness (i915)\n 7) Select Plymouth theme           17) Enable IOMMU (Intel)\n 8) Set dark GTK                    18) Disable PulseAudio suspend\n 9) Select login shell              19) Disable 802.11n\n10) Import Cinnamon dconf           20) Add scripts\n```\n\n3. Select the system font. (Noto or Roboto)\n\n4. Select the system icon theme.\n\n5. Select the system desktop theme (GTK).\n\n6. Select the system desktop theme (Plasma).\n\n7. Select the Plymouth splash screen theme.\n\n8. Set GTK applications to prefer the dark theme.\n\n9. Select default login shell (Bash or Zsh).\n\n10. Import pre-defined dconf settings for Cinnamon.\n\n11. Import pre-defined dconf settings for GNOME.\n\n12. Configure default desktop and application settings for Plasma.\n\n13. Import pre-defined dconf settings for applications.\n\n14. Import GNOME-terminal profiles (Light/Dark) via dconf.\n\n15. Enable autologin for the current user.\n\n16. Invert brightness via kernel command line options in the GRUB prompt.\n\n17. Enable Intel IOMMU for the i915 graphics driver. Helps fix blank displays\n    for Haswell CPUs running kernels \u003e=5.7.\n\n18. Disable PulseAudio suspend (suspend can sometimes cause weird buzzing).\n\n19. Disable 802.11n networking in iwlwifi. May help speed up poor 802.11ac\n    connections.\n\n20. Download and install\n    [general utility scripts](https://github.com/sudorook/misc-scripts).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudorook%2Fdebian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsudorook%2Fdebian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudorook%2Fdebian/lists"}