README.org: Extend Quickstart and add section on container testing

This commit is contained in:
Collin J. Doering 2024-04-13 18:35:35 -04:00
parent 9273b06e88
commit 6b28cab711
Signed by: rekahsoft
GPG Key ID: 7B4DEB93212B3022

View File

@ -17,7 +17,6 @@ These are the dotfiles of the author, managed using guix-home.
- ~.guix-authorizations~ :: Guix authorizations file[fn:1]
- ~.guix-channel~ :: Guix channel file[fn:2]
- ~README.org~ :: Org-mode[fn:3] documentation
- ~TODO.org~ :: Org-mode todo's, known issues and future aspirations
- ~home-manifest.scm~ :: Guix manifest used for cuirass builds (and as needed via the cli)
- ~user-config~ :: Configuration for various programs managed using guix-home
@ -50,14 +49,35 @@ Home configuration, including startup services (via userland shepherd), configur
and installed packages are all managed using [[https://guix.gnu.org][guix]]/[[https://guix.gnu.org/en/manual/devel/en/html_node/Home-Configuration.html][guix-home]] and can be installed with the
following.
First, obtain the projects guix channel file. There are two ways to do this; with http
fetching only the channel file, or with git, fetching the entire dotfiles project; the later
is necessary if you plan on [[*Working with Local Sources][Working with Local Sources]].
#+begin_src shell
mkdir ~/.dotfiles && curl --output-dir ~/.dotfiles -O https://git.rekahsoft.ca/rekahsoft/dotfiles/raw/branch/master/channels.scm
# OR
git clone https://git.rekahsoft.ca:rekahsoft/dotfiles.git ~/.dotfiles
#+end_src
Then, use guix to pull the provided channel file and reconfigure guix-home.
#+begin_src shell
guix pull -C ~/.dotfiles/channels.scm
guix home reconfigure -e '(@ (rekahsoft guix-config home) %home)'
#+end_src
** Try it out in a container!
Thanks to the power of Guix, these dotfiles can be tried out in a container, with the only
prerequisite being guix itself.
#+begin_src shell
guix time-machine -C ~/.dotfiles/channels.scm -- home container -e '(@ (rekahsoft guix-config home) %home)'
#+end_src
* Working with Local Sources
Clone this repository.
Clone this repository, if you haven't already.
#+begin_src shell
git clone <repo> ~/.dotfiles