Nix home-manager

Author: EnigmaCurry

books/linux-workstation.org

@@ -451,37 +451,66 @@ Open the default terminal emulator (foot) with the keyboard shortcut:
 =Win+Enter= (hold down the "Windows" key on your keyboard, then
 simultaneously press Enter.)
 
-My custom config replaces several of the default configuration files.
-So you must first get rid of these files, by renaming them with the
-suffix =.orig= for posterity:
+**** Install Nix
+
+First, enable transient root (required for Nix on rpm-ostree systems):
+
+#+begin_run
+sudo tee /etc/ostree/prepare-root.conf <<'EOF'
+[composefs]
+enabled = yes
+[root]
+transient = true
+EOF
+#+end_run
+
+Track the config in initramfs and reboot:
+
+#+begin_run
+rpm-ostree initramfs-etc --track=/etc/ostree/prepare-root.conf
+systemctl reboot
+#+end_run
+
+After reboot, install Nix using the Determinate Systems installer:
 
 #+begin_run
-mv ~/.config ~/.config.orig
-mv ~/.bashrc ~/.bashrc.orig
-mv ~/.bash_profile ~/.bash_profile.orig
+curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | \
+  sh -s -- install ostree --no-confirm
 #+end_run
 
-Next, install my [[https://github.com/enigmacurry/sway-home][customized sway config repository]] :
+Verify installation:
+
+#+begin_run
+nix --version
+#+end_run
+
+**** Install Home Manager
+
+Clone [[https://github.com/enigmacurry/sway-home][my customized sway config repository]]:
 
 #+begin_run
 git clone https://github.com/enigmacurry/sway-home \
   ~/git/vendor/enigmacurry/sway-home
 #+end_run
 
-Run the included setup script:
+Install the configuration using Home Manager:
 
 #+begin_run
 cd ~/git/vendor/enigmacurry/sway-home
-./setup.sh
+just hm-install
 #+end_run
 
-The =setup.sh= script will make [[https://github.com/EnigmaCurry/sway-home/blob/master/setup.sh#L57-L61][symlinks]] to the repository files from
-the same original paths as the files you just moved. It also asks you
-some questions to help setup your git profile.
+This will install all dotfiles, packages (including Emacs), and shell
+configuration. Any existing files that conflict will be backed up with
+a =.backup= suffix.
+
+During installation, you will be prompted to enter your git user name
+and email if not already configured. This creates a local config file
+at =~/.config/git/config.local= which is not tracked by the
+repository, allowing each user to have their own identity.
 
-Once you have finished entering the information setup asks for, press
-=Win+Shift+E=, and choose Log Out. Log back in, and this will load the
-new config files.
+Once installation completes, press =Win+Shift+E= and choose Log Out.
+Log back in, and this will load the new config files.
 
 *** Setup display resolutions and orientation
 
@@ -1013,110 +1042,32 @@ This will allow you to run the host programs =toolbox=, =podman= and
 [[https://www.gnu.org/software/emacs/][Emacs]] is my long time favorite code editor (IDE) and for writing
 documentation (including this book).
 
-*** Install Emacs
-
-Because Sway runs on Wayland, you'll want to install the Wayland
-(pgtk) version of Emacs. In Fedora 40 onwards, the Wayland (pgtk)
-version is already the default. For Fedora 39, [[https://copr.fedorainfracloud.org/coprs/enigm-a/emacs-pgtk-nativecomp][you can use this COPR]]
-(a COPR is to Fedora what PPA is to Ubuntu and what AUR is to Arch
-Linux), which includes a custom build for Wayland (pgtk).
-
-To enable this, you need to be running your dev distrobox:
-
-#+begin_run
-distrobox enter dev
-#+end_run
-
-Install Emacs:
-
-#+attr_shortcode: :style secondary :title Run this inside the distrobox:
-#+begin_run
-sudo dnf install emacs
-#+end_run
-
-*** Create Emacs script
-
-In order to be able to quickly launch Emacs inside the distrobox from
-the host, you will need a little script installed on the host.
-
-You can create this script and put it in =/usr/local/bin/emacs=. Run
-this on the host (not in the distrobox), to create it as the root user:
-
-#+begin_run
-cat << EOF | sudo tee /usr/local/bin/emacs
-#!/bin/bash
-## Run Emacs in the dev distrobox and pass it any args:
-distrobox enter --name dev -- bash -l -c emacs
-EOF
-sudo chmod a+x /usr/local/bin/emacs
-#+end_run
-
-Now you can run Emacs from the host, and it will run inside the
-Distrobox.
-
-*** Install dependencies
-
-Most Emacs packages are written in Emacs Lisp, and therefore have no
-external dependencies. The one exception is for Vterm terminal
-support, which requires compiling a C library (libvterm). This
-compilation can be done automatically by Emacs, but it requires you
-have some tools preinstalled:
+*** Emacs is already installed
 
- * CMake
- * libtool
+If you followed the [[*Install Home Manager][Home Manager installation]] earlier, Emacs
+(=emacs-pgtk= for native Wayland support) and [[https://github.com/EnigmaCurry/emacs][my configuration]] are
+already installed. 
 
-Install the dependencies inside the distrobox:
+*** Start Emacs
 
-#+attr_shortcode:  :style secondary :title run this inside the distrobox
-#+begin_run
-sudo dnf install cmake libtool
-#+end_run
-
-*** Remove any existing Emacs config
-
-Assuming you want to use my Emacs config, you need to delete any
-existing config you already have. Also note that Emacs creates a
-default config the first time it runs, so if you started Emacs
-already, you may have a config and not even know it.
-
-Here's how to remove the existing Emacs config:
+Run:
 
 #+begin_run
-rm ~/.emacs ~/.emacs.d -rf
+emacs
 #+end_run
 
-*** Install my Emacs config
-
-[[https://github.com/EnigmaCurry/emacs][My Emacs config is on github]]. Install it with the following script:
-
-#+begin_run
-REMOTE=https://github.com/EnigmaCurry/emacs.git
-REPO=${HOME}/git/vendor/enigmacurry/emacs
-BRANCH=straight
+*** Enable modules
 
-(set -e
-test -d ~/.emacs.d && (echo "~/.emacs.d already exists. Aborting install." && exit 1)
-test -d ${REPO} || git clone -b ${BRANCH} ${REMOTE} ${REPO}
-mkdir ~/.emacs.d && ls -1 ${REPO}/*.el | xargs -iXX ln -s XX ~/.emacs.d
-mkdir ~/.emacs.d/straight && ln -s ${REPO}/straight-versions ~/.emacs.d/straight/versions
-ln -s ${REPO}/snippets ~/.emacs.d/snippets
-)
-#+end_run
+My config is composed of several optional modules. The initial config
+has zero modules loaded by default. To enable them, you must run:
 
-*** Start Emacs to finish the installation
+#+begin_example
+M-x my/machine-labels-enable-all
+#+end_example
 
-The first time Emacs starts, it will install all of the dependencies
-listed in the main config file =~/.emacs.d/init.el=.
-
-Run:
-
-#+begin_run
-emacs
-#+end_run
-
-Wait for everything to install. You may see a blank screen for up to
-10 minutes, but you should see some minimal information of the
-progress in the bottom minibuffer.
+Then restart Emacs, and wait for everything to install. You may see a
+blank screen for up to 10 minutes, but you should see some minimal
+information of the progress in the bottom minibuffer.
 
 If it gets stuck at any point, quit and restart it, and it should
 continue where it left off. If you get any error message, you may want
@@ -1129,10 +1080,9 @@ emacs --debug-init
 This will usually give you a more verbose error message which can be
 helpful in debugging the startup.
 
-
 *** Read the README for my config
 
-More notes are available in the [[https://github.com/EnigmaCurry/emacs#readme][README]].
+You can read more about this config at [[https://emacs.rymcg.tech][emacs.rymcg.tech]]
 
 ** SSH
 :PROPERTIES:
@@ -1242,41 +1192,16 @@ when you log in. (In the case of the solokey, the key is never held in
 memory, but you still need to hold the identity of it in the
 ssh-agent.)
 
-Keychain is a program that helps you setup the ssh-agent. Install
-=keychain= in each of your distroboxes and/or workstations:
-
-#+attr_shortcode: :title Run this on your Fedora workstations: :style secondary
-#+begin_run
-sudo dnf install keychain
-#+end_run
-
-#+attr_shortcode: :title Run this on your Debian / Ubuntu workstations: :style secondary
-#+begin_run
-sudo apt install keychain
-#+end_run
-
-#+attr_shortcode: :title Run this on your Arch Linux workstations: :style secondary
-#+begin_run
-sudo pacman -S keychain
-#+end_run
-
-To configure keychain, edit your =~/.bashrc= file:
-
-#+attr_shortcode: :file ~/.bashrc
-#+begin_edit
-## Put this line in your ~/.bashrc:
-## (If you're using my config, this is already in it.)
-eval $(keychain --eval --quiet)
-#+end_edit
+Keychain is a program that helps you setup the ssh-agent. If you
+installed [[*Install Home Manager][Home Manager]] earlier, =keychain= is already installed
+via Nix, and is already configured in your =~/.bashrc=.
 
-Log out of your desktop session, and log back in. Open your terminal,
-and you should be automatically prompted to enter your SSH passphrase.
-Once you have entered the passphrase, the SSH key will remain resident
-in memory until you log out.
+When you open your terminal, you should be automatically prompted to
+enter your SSH passphrase. Once you have entered the passphrase, the
+SSH key will remain resident in memory until you log out.
 
 Double check that the key has been loaded, run:
 
-#+attr_shortcode: :title run this inside your distrobox
 #+begin_run
 ssh-add -L
 #+end_run
@@ -1294,7 +1219,6 @@ Apparently, keychain does not yet know how to load the Solokey
 automatically. You must add the Solokey to the ssh-agent manually, one
 time, each time you boot your workstation:
 
-#+attr_shortcode: :title run this inside your distrobox
 #+begin_run
 ## Do this to load your Solokey into the ssh-agent:
 ssh-add -K