guix-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH] Quick-start guide


From: yoosty
Subject: [PATCH] Quick-start guide
Date: Sat, 4 Jun 2016 13:00:17 -0700

Howdy!

This is my first submission, please be gentle ;)

Input is definitely welcome.


diff --git a/doc/contributing.texi b/doc/contributing.texi
index 208c6af..46c652f 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -18,6 +18,7 @@ the @file{CODE-OF-CONDUCT} file in the source tree.
address@hidden
 * Building from Git::           The latest and greatest.
 * Running Guix Before It Is Installed::  Hacker tricks.
+* Quick Setup::                 The quick and easy tools
 * The Perfect Setup::           The right tools.
 * Coding Style::                Hygiene of the contributor.
 * Submitting Patches::          Share your work.
@@ -153,6 +154,75 @@ the @file{/root/.config/guix/latest} symlink to point to
address@hidden as your user does.}
 
 
address@hidden Quick Setup
address@hidden Quick Setup
+
+So you just want the quick-and-dirty guide? Assuming you have some familiarity
+with GNU/Linux systems in general and have installed one several times before
+you can probably get started with a few notes while citing
address@hidden Distribution} as necessary. As this is a quick-setup guide we'll use
+some example defaults.
+
+The general idea is that you will:
address@hidden
address@hidden @uref{https://gnu.org/software/guix/download/, Download} the USB installer
address@hidden Transfer the image to a USB stick (@pxref{USB Stick Installation})
+using dd
address@hidden Boot the USB stick
address@hidden Configure @pxref{Preparing for Installation,Networking}
address@hidden Set your @xref{Preparing for Installation,Disk Partitioning}
+(using an msdos label instead of a gpt label might be easier at the moment)
address@hidden Mount your partitions (e.g. /mnt)
address@hidden Run (again, e.g. /mnt) @command{herd start cow-store /mnt}
address@hidden Create a system configuration file using
address@hidden with the Installation} and
address@hidden the Configuration System} as guides. It is suggested to start
+with the bare-bones template as you can easily re-configure your system
+once it is up.
address@hidden Using /mnt/root/guix_configs/config00.scm as the example config file
+and /mnt as the example install mount point, run
address@hidden system init /mnt/root/guix_configs/config00.scm /mnt}
address@hidden Cross your fingers and grab a beer
address@hidden If you're using reasonably new hardware and a bare-bones config
+then guix should be done before your beverage and you can run
address@hidden
address@hidden itemize
+
+Now you should be ready to rock! Don't forget to set your user passwords.
+
+Of course, you're not here just to have a working system are you, you want
+to dive in to the source, right? Let's take a quick look at that as well.
+This guide assumes that you have at least perused @pxref{Building from Git}.
+First you might want to head to
address@hiddenhttp://git.savannah.gnu.org/cgit/guix.git, the Guix Git page} and browse
+around. We're going to assume that you utilized a bare-bones config as per the
+quick install guide above. In this short example you will be shown simply
+how to change the release version of Guix (not something you will likely do
+but an easy and fun example).
+
address@hidden
address@hidden Install git in to your user's profile: @command{guix package --install git}
address@hidden Create a directory for your git checkout (e.g. @command{mkdir ~/git_repos})
address@hidden Clone the Guix repository:
address@hidden ~/git_repos/; git clone git://git.sv.gnu.org/guix.git; cd guix}
address@hidden To make the simple version change:
address@hidden([GNU Guix], [0.10.0], [bug-guix@@gnu.org], [guix],}
+to
address@hidden([GNU Guix], [0.10.42], [bug-guix@@gnu.org], [guix],}
address@hidden Check your change with: @command{git diff configure.ac}
address@hidden Let Guix set up your Guix build
+environment:@command{guix environment guix}
address@hidden Build Guix:
address@hidden/bootstrap ; ./configure --localstatedir=/var ; make}
address@hidden Run the daemon in a pre-installation environment:
address@hidden ./pre-inst-env guix-daemon --build-users-group=guixbuild}
address@hidden Switch to a new terminal
address@hidden Check the pre-installation environement daemon's version:
address@hidden/git_repos/guix/pre-inst-env guix --version}
address@hidden Your version output should be updated!
address@hidden itemize
+
+
address@hidden The Perfect Setup
address@hidden The Perfect Setup
 

--

   .:Justin:.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]