Installation

Prerequisites

A network connection is required. A basic network configuration for systemd-networkd is shown below:

>/etc/systemd/network/90-wired.network <<-EOF cat
	[Match]
	Name=en*

	[Network]
	Description=Wired Connection
	DHCP=yes
	DNS=1.1.1.1
EOF

systemctl daemon-reload
systemctl enable --now systemd-{network,resolve}d

Remember to copy important data from your old computer! See your Setting up Linux note.

Bootstrap

Download and execute bootstrap-linux.sh to begin the bootstrap process:

mkdir -p ~/.bootstrap
curl -#fsSLo ~/.bootstrap/bootstrap.sh 'https://raw.githubusercontent.com/hyperupcall/dotfiles/trunk/bootstrap-linux.sh'
chmod +x ~/.bootstrap/bootstrap.sh
~/.bootstrap/bootstrap.sh

The bootstrap script performs the following steps:

  • Installs Homebrew on macOS
  • Installs cURL, Git, Vim, and Zsh
  • Clones hyperupcall/dotfiles to ~/.dotfiles
  • Symlinks ~/scripts to ~/.dotfiles/scripts
  • Creates ~/.bootstrap/bootstrap-out.sh. Sourcing it:
    • Sets NAME, EMAIL, EDITOR, and VISUAL
    • Prepends $HOME/.dotfiles/.data/bin and $HOME/.locall/bin to PATH
    • Sources ~/.dotfiles/config/xdg.sh, if it exists

Next Steps

Additional scripts should be executed. They include:

  • . ~/.bootstrap/bootstrap-out.sh
  • If on Ubuntu, run sudo apt-get remove coreutils-from-uutils --allow-remove-essential
  • ~/scripts/rare/transfer-secrets.sh
  • Setup ZFS, BTRFS
  • ~/scripts/doctor.sh
    • Setup Browsers (Firefox, Brave)
      • Backup and restore settings (do manually):
        • uBlacklist
        • uBlock Origin
        • SponsorBlock
        • ViolentMonkey
      • Sync data (do manually)
    • Setup Maestral
    • Setup Visual Studio Code
      • Install extensions (do manually)
    • Setup Thunderbird
      • Install extensions (do manually)
    • Setup Bats, gh
  • Configure AppImageLauncher
    • Set destination directory
  • Setup Albert
    • Enable plugins
  • Setup Obsidian
  • Setup LibreOffice
    • Backup and restore (do manually)
      • SpellCheck dictionary
      • Document templates
  • Configure keybindings
  • Test spellchecker
  • Add favorites to file explorer and dock