My Dotfiles

Note

This Nix configuration is possible thanks to soramanew and their work creating Caelestia. All I have done is use it and made some minor modifications elsewhere to put together a working system for myself.

Installation

Presuming you're starting from a live boot with nothing yet done to your machine, you'll want to install NixOS on your machine from a minimal installation.

When going through the live boot installer, choose No Desktop when prompted on which desktop environment to choose; you will not need one for this configuration.

Working From A Minimal Installation

Setting Up A Network Connection — WiFi

For WiFi users, you'll also want to connect to a network if you haven't yet.

$ nmcli device wifi list
$ nmcli device wifi connect "<SSID>" password "<PASSWORD>"
$ ping google.com

Verify that you have a connection by pinging a website. If you have successfully connected to your network, proceed with rebuilding your system.

Adding The Git Package

Once you've successfully booted into your new installation and have logged in, install git in a temporary nix shell:

nix-shell -p git

Afterwards, clone this repository into the ~/.config/nixos directory:

git clone https://github.com/toxocious/dotfiles.git $HOME/.config/nixos --branch NixOS

Before running the included installation script, be sure to copy the generated hardware configuration file into this repository:

sudo cp /etc/nixos/hardware-configuration.nix ./.config/nixos/hosts/desktop

If you don't do this, there's a good chance that the installation will break OR will brick your system upon restarting.

Now you may proceed with the initial installation:

./install.sh

The initial installation process will take a fair amount of time as it downloads and installs all necessary packages and dependencies.

Expect this to take around 10 to 20 minutes on a fresh system.

Notice

Do NOT run the installation script as an administrator.

Doing so will cause directories to potentially be created in the wrong place.

Ths install script will likely take several minutes.

The installer will create symlinks and overwrite existing files.

Please backup your current configs before installing.

Installing Unpackaged VS Code Extensions

Generally, VS Code extensions can be added by adding <author>.<package-name> to the programs.vscode.extensions array in the development/default.nix file.

You can find a list of all pre-packaged extensions via search.nixos.com.

In the case where you use one or more extensions that aren't pre-packaged there, you can have Nix fetch them and install them for you by providing the following declaration in development/default.nix.

{
    name = "extension-name";
    publisher = "extension-author";
    version = "extension-version";
    sha256 = "sha256-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=;
}

To get the correct sha256 hash to use, you can use the following shell command:

nix-prefetch-url "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/<EXTENSION_AUTHOR>/vsextensions/<EXTENSION_NAME>/<EXTENSION_VERSION>/vspackage" | xargs -I {} nix hash to-sri --type sha256 {}

Which should give you a valid sha256 hash output:

[jess@athena:~/.config/nixos]$ nix-prefetch-url "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/alexandernanberg/vsextensions/horizon-theme-vscode/1.0.1/vspackage" | xargs -I {} nix hash to-sri --type sha256 {}
path is '/nix/store/4iq3yz8j5afyqcicirszshkqcz49qvja-vspackage'
sha256-jdtc/v4aX5wAjcs0bIpL808l4EA3o362u0sgzas27YU=

Once done, simply rebuild your system via the included installation script.