Dotfiles

acro5piano's personal dotfiles. It aims to automate setup my development PC idempotently.

Core technologies:

• Arch Linux
• Sway
• Neovim
• Alacritty
• keyd/Xremap
• Brave Browser

Setup process

The following document assumes you have:

• A UEFI boot device
• No multie boot device (Windows multi boot document below)

Install Arch Linux

• Create arch linux install usb.
  • download the latest iso image
  • cp /path/to/iso /dev/sdX
• Boot to usb

File system (UEFI)

select disk to write arch linux

cfdisk /dev/nvme0n1

• Create a partition for UEFI /dev/nvme0n1p1
  • create a new partition and set 1G size for it
  • Set the type to EFI System
• Create a partition for swap (for hibernation) /dev/nvme0n1p2
  • create a new partition and set 40G size for it (I have 24GB machine)
  • Set the type to Linux swap
• Create a partition for main /dev/nvme0n1p3
  • create a new partition and set maximum size for it
  • Set the type to Linux Filesystem
• write out

Swap is required for hibernation.

# UEFI
mkfs.fat -F32 /dev/nvme0n1p1
mkswap /dev/nvme0n1p2
swapon /dev/nvme0n1p2
mkfs.ext4 /dev/nvme0n1p3
mount /dev/nvme0n1p3 /mnt
mkdir /mnt/boot
mount /dev/nvme0n1p1 /mnt/boot

Install base system

# Connect to a Network
iwctl

pacstrap /mnt base base-devel linux-zen linux-zen-headers linux-firmware iwd python git vim neovim
genfstab -U /mnt >> /mnt/etc/fstab

# Enter new arch
arch-chroot /mnt

# Configure iwd
cat <<'EOF'| sudo tee /etc/iwd/main.conf
[General]
EnableNetworkConfiguration=true
EOF

# Connect to a Network
iwctl

# install /boot
bootctl install

Create /boot/loader/entries/arch.conf

title Arch Linux Zen
linux /vmlinuz-linux-zen
initrd /initramfs-linux-zen.img

options root=UUID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx acpi_backlight=native rw resume=UUID=xxxxxxxxxxxxxxxxxxxx

Add user:

# add user
useradd --create-home kazuya
passwd kazuya
gpasswd -a kazuya wheel
EDITOR=vim sudo visudo

Then exit and reboot.

Notes:

• Python is required because we use Ansible later.
• If you have any problems on resolving name, edit /etc/systemd/resolved.conf and fix dns to 8.8.8.8.
• systemd-boot is pre-installed and simple to use than Grub unless dual boot with Windows.

Add user

Run the following commands as root:

visudo /etc/sudoers.d/admin

# Recommended config:
#   %wheel ALL=(ALL) ALL
#   %wheel ALL=NOPASSWD: /bin/systemctl restart iwd
#   %wheel ALL=NOPASSWD: /bin/systemctl restart bluetooth
#   %wheel ALL=NOPASSWD: /home/kazuya/bin/connect-client-vpn
#   %wheel ALL=NOPASSWD: /home/kazuya/bin/connect-client-vpn-stop

exit

and login as kazuya:

localhost login> kazuya
password:

Install dotfiles

then install dotfiles:

cd ~
git clone git@github.com:/acro5piano/dotfiles $HOME/.dotfiles
cd $HOME/.dotfiles
python -m ensurepip
export PATH=$PATH:~/.local/bin/
pip install ansible
ansible-galaxy collection install community.general kewlfft.aur
ansible-playbook --ask-become-pass ansible/main.yml

For groups, please take a look at:

https://github.com//acro5piano/dotfiles/blob/e0ef379e4326bd102abddc28bd5946b52cbeee06/pkg_init/arch#L1

Copy large & secure files

mkdir $HOME/var
scp -r 192.168.xxx.yyy:/home/kazuya/var/music $HOME/var/music
scp -r 192.168.xxx.yyy:/home/kazuya/.aws $HOME/.aws
scp -r 192.168.xxx.yyy:/home/kazuya/.ssh $HOME/.ssh

Bluetooth

By default bluetooth connection takes too much time. Here is the fix: https://gist.github.com/andrebrait/961cefe730f4a2c41f57911e6195e444#enable-bluetooth-fast-connect-config

Maintain

# Sync dotfiles only ansible-playbook ansible/main.yml --tags dotfiles

# Install pacman dep only
ansible-playbook --ask-become-pass ansible/main.yml --tags pacman

OSX

ansible-playbook ansible/main.yml --tags dotfiles,misc,npm,pip,gem --extra-vars "os=mac"

Windows Multi boot

For Windows Multi boot environment, do this before cfdisk phase:

• On windows,
  • Reduce Windows partition to minimum 80GB
  • Create a blank partition for Linux

And use this commands for the initial setup, replacing systemd-boot thing (as Grub is easier than systemd-boot if you do multi-boot):

# systemd-boot
mkdir /boot
mount /dev/sda1 /boot

# Grub
os-prober
grub-install
grub-mkconfig -o /boot/grub/grub.cfg

# Grub options
nvim /etc/default/grub # Enable this line: GRUB_DISABLE_OS_PROBER=false

Windows + WSL2 Arch

For Windows, use them:

• Wezterm (To support select-to-copy on Surface touch screen)
• WSL2 Arch
• PowerToys (To customize key bindings on Browsers)

For Arch installation, see the awesome https://github.com/yuk7/ArchWSL

Tweaks of installation process

Before git clone:

export PATH=$PATH:~/.local/bin/
sudo pacman -Syu git openssh

Replace the Ansile command with:

ansible-playbook wsl/ansible/main.yml
ansible-playbook ansible/main.yml --tags pip,npm,misc
chsh -s /usr/bin/fish

Enable hibernation with swap partition

Linux supports swapfile, but it is not reliable as of 2024. swapfile causes the hibernate inconsistent memory map detected error while resuming.

Specify swap partition

# /etc/fstab

UUID=7efab515-xxxx-xxxx-xxxx-7e17afceeacb none swap defaults 0 0

Modify HOOKS in mkinitcpio config like this:

# /etc/mkinitcpio.conf

HOOKS=(base udev autodetect keyboard modconf block filesystems resume fsck)

Then run

sudo mkinitcpio -p linux

Add resume to the kernel parameter:

# /boot/loader/entries/arch.conf

options root=UUID=63f7f18e-xxxx-xxxx-xxxx-e3fc0e2e4666 resume=UUID=7efab515-xxxx-xxxx-xxxx-7e17afceeacb acpi_backlight=native rw

You also may want to change the power button behavior:

/etc/systemd/logind.conf

# ...
HandlePowerKey=hibernate
HandleLidSwitch=ignore
# ...

Tweak Bluetooth config

Follow https://gist.github.com/acro5piano/9606ce598e04c10dde1948cf7e098f80

Bluez 5.73 may contain a bug which the service hangs up after hibernation. For the time being, let's use 5.72.

sudo pacman -U /var/cache/pacman/pkg/bluez-5.72-2-x86_64.pkg.tar.zst /var/cache/pacman/pkg/bluez-libs-5.72-2-x86_64.pkg.tar.zst /var/cache/pacman/pkg/bluez-utils-5.72-2-x86_64.pkg.tar.zst

Backlight is wrong

If light does not work properly, try to modify the kernel parameter:

~> cat /boot/loader/entries/arch.conf
options root=UUID=... acpi_backlight=native rw

ref: https://bbs.archlinux.org/viewtopic.php?id=282805

ChatGPT CLI

curl -L -o chatgpt https://github.com/kardolus/chatgpt-cli/releases/latest/download/chatgpt-linux-amd64 && chmod +x chatgpt && mv chatgpt ~/.local/bin

Joplin

wget -O - https://raw.githubusercontent.com/laurent22/joplin/dev/Joplin_install_and_update.sh | bash

pnpm completion

Not works. use Yarn completion for now.

pnpm completion fish > ~/.config/fish/completions/pnpm.fish

Aider

pipx install aider-install
aider-install