dotfiles/setup/ubuntu-setup.md

Ubuntu Setup

Here's my personal Ubuntu 23.04 setup. (Make sure to use Wayland on Nvidia!)

Packages

• Must haves:
  • sudo apt install curl ddcutil deja-dup earlyoom endeavour ffmpeg flatpak git gnome-boxes gnome-clocks gnome-software-plugin-flatpak gnome-sound-recorder gnome-weather goldendict gparted keepassxc mpv needrestart obs-studio ripgrep shadowsocks-libev sshfs synaptic tmux trash-cli ufw vim-gtk3 wl-clipboard linux-tools-generic build-essential
• Optional:
  • sudo apt install arp-scan asciinema bookworm foliate gimp gnome-firmware gnome-games gnome-nettool gnome-packagekit gnome-passwordsafe gnome-shell-pomodoro gnome-usage gthumb heif-gdk-pixbuf heif-thumbnailer mkvtoolnix-gui openjdk-17-jdk pulseeffectsqpdf ranger syncplay virtualbox-qt vlc audacity f3
• Remove all snaps:

  • # if this command fails, do the following then try again:
    # sudo umount /var/snap/firefox/common/host-hunspell
    sudo apt autoremove --purge snapd
    sudo apt-mark hold snapd
    trash ~/snap
    

• Enable FlatHub:
  • flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
• earlyoom config: edit /etc/default/earlyoom and add:
  • --avoid '(^|/)(systemd|sshd|mosh-server|ssh|vim|sudo|sudoedit|gnome-shell|gnome-terminal-)$' --prefer '(^|/)(Web Content|Isolated Web Co)$'
• ddcutil for monitor brightness shortcuts:
  • sudo usermod -aG i2c $(whoami)
  • External Monitor Brightness Up: ddcutil setvcp 10 + 10
  • External Monitor Brightness Down: ddcutil setvcp 10 - 10

Optional packages

• clangd for VSCodium C language server with llvm-vs-code-extensions.vscode-clangd (?)
• imagemagick for convert, comment out with <!-- --> PDF policy in /etc/ImageMagick-6/policy.xml (?)
• Cross compiling (?)
  • gcc-aarch64-linux-gnu
  • gcc-arm-linux-gnueabihf
• Virtualbox
  • sudo usermod -aG vboxusers $(whoami)
• Birdtray
  • $ sudo apt install birdtray
  • Configure it by running birdtray and clicking on the tray icon
  • In Startup Applications Preference:
    • Name: Birdtray
    • Command: sh -c "sleep 20 && /usr/bin/birdtray"
    • Comment: Minimize to tray for Thunderbird
    • Wait for bugs to be fixed before removing sleep:
      • https://github.com/gyunaev/birdtray/issues/362
      • https://github.com/gyunaev/birdtray/issues/430
  • Hiding: check all except hide/show by clicking icon

Apps

• gnome-tweaks
  • sudo apt install gnome-tweaks
• Extensions
  • sudo apt install gnome-shell-extensions
• Go to settings -> Region & Language and install Chinese (simplified).
• GSConnect
  • sudo apt install gnome-shell-extension-gsconnect
  • UFW:
    • sudo ufw allow 1716:1764/tcp
    • sudo ufw allow 1716:1764/udp
• Flatseal
  • flatpak install flathub com.github.tchx84.Flatseal
• Firefox
  • flatpak install flathub org.mozilla.firefox
  • Use Wayland for correct fractional scaling and less bugginess sudo flatpak override --socket=wayland --env=MOZ_ENABLE_WAYLAND=1 org.mozilla.firefox
• Xournal++
  • sudo apt install xournalpp texlive-latex-extra
• cameractrls
  • flatpak install hu.irl.cameractrls
• Minecraft
  • flatpak install flathub org.prismlauncher.PrismLauncher
  • To host servers: sudo ufw allow 25565/tcp
• Bottles
  • flatpak install flathub com.usebottles.bottles
• Discord
  • flatpak install flathub com.discordapp.Discord
• Slack
  • flatpak install flathub com.slack.Slack
• Denaro
  • flatpak install flathub org.nickvision.money

Optional Apps

• Zoom
  • flatpak install flathub us.zoom.Zoom
• Impatience (adjust Gnome animation speed)
  • sudo apt install gnome-shell-extension-impatience
  • Enable in extensions and set speed to 0.7
• Wobbly Windows (?)
  • From https://extensions.gnome.org/extension/2950/compiz-alike-windows-effect/
  • Turn off maximize effect
  • Increase restore factor to 5
• System monitor
  • $ sudo apt install gnome-shell-extension-system-monitor
  • Show only CPU (digit and graph) and memory (digit).
• OpenWeatherMap
  • $ sudo apt install gnome-shell-extension-weather
  • On older systems (< 21.04), download and install from https://extensions.gnome.org/extension/750/openweather/
  • Set location to La Jolla
  • Switch to metric units
• VS Codium
  • flatpak install flathub com.vscodium.codium
• Birdtray
  • $ sudo apt install birdtray
  • Configure it by running birdtray and clicking on the tray icon
  • In Startup Applications Preference:
    • Name: Birdtray
    • Command: sh -c "sleep 20 && /usr/bin/birdtray"
    • Comment: Minimize to tray for Thunderbird
    • Wait for bugs to be fixed before removing sleep:
      • https://github.com/gyunaev/birdtray/issues/362
      • https://github.com/gyunaev/birdtray/issues/430
  • Hiding: check all except hide/show by clicking icon
  • Broken on Wayland
• Android Studio
  • Move Ctrl+S from IdeaVim to IDE
  • Enabled Mark modified (*)
  • Disable both Save files on frame deactivation and Save files automatically if application is idle

Services & System configs

Swap partition/file

• Allocate 16 GiB for LVM swap partition (if not set during installation):

  sudo lvcreate -n lvswap-ubuntu-23.04 -L 16G -C y vgroot
  # note down UUID:
  sudo mkswap /dev/mapper/vgroot-lvswap--ubuntu--23.04
  echo 'UUID=<UUID> none swap swap 0 0' | sudo tee -a /etc/fstab > /dev/null
  sudo swapon -a
  

• Or, allocate 8 GiB for swapfile:

  # if /swapfile already exists
  sudo swapoff /swapfile
  sudo fallocate -l 8GiB /swapfile
  sudo chmod 0600 /swapfile
  sudo mkswap /swapfile
  sudo swapon /swapfile
  echo '/swapfile none swap defaults 0 0' | sudo tee -a /etc/fstab > /dev/null
  

UFW

$ sudo ufw enable

OpenSSH Server & Mosh

Installation and configuration:

sudo apt install -y openssh-server mosh
sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
sudo cp ../system/sshd/sshd_config /etc/ssh/sshd_config
sudo groupadd --system ssh-users
sudo usermod -aG ssh-users $(whoami)
sudo systemctl enable sshd --now
sudo systemctl reload sshd

Firewall:

sudo ufw limit OpenSSH
sudo ufw allow 60001:60999/udp

Per user:

mkdir -p ~/.ssh
chmod 700 ~/.ssh
# insert your SSH public keys into this file
touch ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

My system level dotfiles

See the system folder and run each script as they apply to your installation.

See logs as admin (if not yet in adm group)

sudo usermod -aG adm $(whoami)

Legacy

For old Ubuntu versions

• OBS Studio
  • On Ubuntu <= 22.10, fixed in 23.04:
    • $ sudo apt install qtwayland5
  • On Ubuntu < 22.10, in /usr/share/applications/com.obsproject.Studio.desktop, replace Exec=obs with Exec=sh -c '[ "$XDG_SESSION_TYPE" = "wayland" ] && obs -platform wayland || obs'
• Xournal++
  • < Ubuntu 22.04
    • flatpak install flathub com.github.xournalpp.xournalpp
    • flatpak install flathub org.freedesktop.Sdk.Extension.texlive and choose newest (21.08 at time of writing) for LaTeX support.
• OpenSSH server config deprecated alias for KbdInteractiveAuthentication
  • ChallengeResponseAuthentication
• Mosh: trusted PPA from mosh developer for truecolor support
  • < Ubuntu 23.04
    • sudo add-apt-repository ppa:keithw/mosh-dev
• Firefox
  • < 23.04
    • Forcing Wayland in Flatpak Firefox may consume more CPU in certain cases with gnome-shell taking close to 100% CPU
• Digimend for Huion tablet (works with H640p)
  • >= 21.10 & using Wayland: no longer necessary
  • = 21.04:
    • $ sudo apt install digimend-dkms
    • Reboot.
  • < 21.04:
    • Download and install from https://github.com/DIGImend/digimend-kernel-drivers.
• Nvidia proprietary driver screen tearing fix
  • Ubuntu < 22.04
    • `echo 'options nvidia-drm modeset=1' | sudo tee /etc/modprobe.d/nvidia-drm-nomodeset.conf

      /dev/null`

Dual booting with Windows

Dislocker

$ sudo apt install dislocker
$ sudo mkdir /media/"$(whoami)" /mnt/dislocker /opt/dislocker
$ sudo chmod 700 /media/"$(whoami)" /mnt/dislocker /opt/dislocker
$ sudo chown $user:$user /media/"$(whoami)"
$ sudo chown root:root /mnt/dislocker /opt/dislocker

Copy the .BEK file to /opt/dislocker/"$(whoami)".bek.

$ sudo chown root:root /opt/dislocker/"$(whoami)".bek
$ sudo chmod 700 /opt/dislocker/"$(whoami)".bek

Add the following lines to /etc/fstab with <user> replaced:

/dev/nvme0n1p6 /mnt/dislocker fuse.dislocker nofail,nouser,umask=0077,bekfile=/opt/dislocker/<user>.bek 0 0
/mnt/dislocker/dislocker-file /media/<user> auto nofail,umask=0077,gid=<user>,uid=<user> 0 0

Mount manually with:

$ sudo dislocker /dev/nvmen1p6 -p -- /mnt/dislocker
$ sudo mount -o loop /mnt/dislocker/dislocker-file /media/"$(whoami)"

Unused

Wayland, if it doesn't show up

• sudoedit /usr/lib/udev/rules.d/61-gdm.rules and comment the two uncommented lines
• Reboot or restart gdm3 (didn't try)

Razer mouse

sudo add-apt-repository ppa:polychromatic/stable
sudo apt install openrazer-meta polychromatic

Grub background

Tool:

• $ sudo apt install grub-customizer
• Put in background manually

Manual Script:

sudo mkdir /opt/grub
sudo cp -r background/ /boot/grub/
sudo chown -R root:root /opt/grub
sudo chmod -R 700 /opt/grub

• Add the following lines to /opt/grub/cycle-backgrounds.sh:

  #!/bin/sh
  cd /boot/grub/background
  mv background.png tmp.png
  mv background-1.png background.png
  mv tmp.png background-1.png
  

• $ sudo chown root:root /opt/grub/cycle-backgrounds.sh
• $ sudo chmod 700 /opt/grub/cycle-backgrounds.sh
• Add @reboot /opt/grub/cycle-backgrounds.sh to root crontab.
• In /etc/default/grub:
  • Add GRUB_BACKGROUND=/boot/grub/background/background.png
  • Change GRUB_TIMEOUT=10 to GRUB_TIMEOUT=3
• $ sudo update-grub

Proton black screen fix

Source: https://github.com/ValveSoftware/steam-runtime/issues/312#issuecomment-739441559

sudo mv /usr/share/vulkan/icd.d/intel_icd.x86_64.json \
	/usr/share/vulkan/icd.d/intel_icd.x86_64.json.disabled

Proprietary encodings

• $ sudo apt install ubuntu-restricted-extras

Blank screen workaround

Blanked screen doesn't wake up after locking [drmModeAtomicCommit: Argument invalide] [drmModeAtomicCommit: Invalid argument] - Put MUTTER_DEBUG_ENABLE_ATOMIC_KMS=0 in /etc/environment