Skip to content

Latest commit

 

History

History
157 lines (101 loc) · 3.72 KB

installation_guide.md

File metadata and controls

157 lines (101 loc) · 3.72 KB

Installation Guide

1. Update and install

Debian

Update installed packages and install packages needed for setup.

sudo apt update
sudo apt upgrade

# curl for installation script et al.
# xz for nix install
# build-essentials & pkg-config for rust related things
sudo apt install \
  curl \
  xz-utils \
  build-essential \
  pkg-config

MacOS

Install xcode-select developer tools to enable setup.

xcode-select --install

2. Locale (Debian only)

Reconfigure locale to include en_GB (source).

sudo locale-gen en_GB.UTF-8; \
sudo dpkg-reconfigure locales

N.B. Select both en_GB.UTF8 and en_US.UTF8 - default to GB

3. Install nix and home-manager

Configuring channels.

MacOS

nix-channel --add https://github.com/nix-community/home-manager/archive/release-24.11.tar.gz home-manager; \
nix-channel --add https://nixos.org/channels/nixpkgs-24.11-darwin nixpkgs;

*nix

nix-channel --add https://github.com/nix-community/home-manager/archive/release-24.11.tar.gz home-manager; \
nix-channel --add https://nixos.org/channels/nixos-24.11 nixpkgs;

4. Generate ssh key

Generate an ssh key

ssh-keygen -C `hostname`

Upload to

4. Install dotfiles

Run the following and follow the steps.

curl -sfL https://git.io/JsiiF | sh

This will:

5. Setup user (Debian only)

Ensure user has a password set - usually required on a fresh Crostini install.

sudo passwd `whoami`

6. Setup shell

Add nix installed zsh to allowed shells and change shell to it.

which zsh | sudo tee --append /etc/shells; \
chsh -s `which zsh`

7. Setup Homebrew (MacOS only)

After following the homebrew installation instructions we'll want our blessed homebrew packages installing. These are in our Brewfile which can be installed with the following command.

brew bundle install --global

8. Font Installation

Ensure chezmoi config specifies the appropriate font name (see here).

The selected Nerd font should

  • have ligature support - filename shouldn't contain NL (No Ligatures)
  • is suitable for terminals / monospaced applications - has Mono suffix

N.B. As of writing this alacritty does not support ligatures.

MacOS

MacOS will use homebrew to install the fonts. Use MacOS' builtin Font Book app to verify the font name.

Linux

Running chezmoi apply should put the JetBrainsMono Nerd font files in the correct directory. Following this you'll need to reload the system font cache with

fc-cache -r

The following will show the installed font name and supported styles, e.g. italic, etc.

fc-list | grep JetBrains

Windows

Double-click each of the font files in the fonts directory. As of Nerd font v3 there are no Windows specific font files, each font should support all systems.

9. Misc

bat doesn't bundle the Catppuccin theme so the theme files that are part of this repo need adding to the bat theme cache.

bat cache --build

See the docs