This is the master branch of nixpkgs, initially pulled from commit 8debf2f9a63d54ae4f28994290437ba54c681c7b The intent of this repo is to be merged onto nixpkgs master. This will also be of help for https://git.suyu.dev/BoomMicrophone/suyu-nix-test which I will need in order for development (it will also be helpful to know what to do for setting up the environment for the master server. Currently I am focusing on this so I can actually see what is still missing) This repo will be removed once the PR to the nixpkgs github goes through
Find a file
Eelco Dolstra 75e1652f05 * Chroot ntpd.
svn path=/nixos/trunk/; revision=7464
2006-12-22 19:29:18 +00:00
boot * Options for overriding the set of kernel modules in the initrd. 2006-12-19 22:12:44 +00:00
configuration * Don't run ntpd as root. 2006-12-22 19:23:19 +00:00
helpers * Use getenv/useradd. 2006-12-18 15:48:29 +00:00
installer * More installer fixes. 2006-12-17 00:10:28 +00:00
instances * Upstart job to start swapping to the devices or files listed in the 2006-12-21 01:07:23 +00:00
upstart-jobs * Chroot ntpd. 2006-12-22 19:29:18 +00:00
README add instruction to add symlink to nixpkgs 2006-12-18 00:12:45 +00:00
STABLE * Version number, stable marker. 2006-11-04 11:27:08 +00:00
test.sh * Use the configuration in /etc/nixos/configuration.nix by default. 2006-12-12 00:08:26 +00:00
upgrade.sh * Use nix-env --set. 2006-12-13 12:21:06 +00:00
VERSION * Version number, stable marker. 2006-11-04 11:27:08 +00:00

*** Building the installation CD ***

- Make sure that you have a very recent Nix.

- Pull from the Nixpkgs channel to speed up building.

- Check out https://svn.cs.uu.nl:12443/repos/trace/nixos/trunk/.

- make a symbolic link called "pkgs" to the location of Nixpkgs

- Build the ISO image:

  $ nix-build instances/rescue-cd.nix -A rescueCD

  This gives you an image in result/iso/nixos.iso.

- Burn the ISO image or attach it to a CD-ROM drive in VMware.


*** Installation ***

- Boot from the CD.

- The CD contains a pretty complete NixOS installation.  When it's
  finished booting, it should have detected most of your hardware and
  brought up networking (check ifconfig).  Networking is necessary for
  the installer.  It's best if you have a DHCP server on your
  network.  Otherwise configure manually.

- Login as "root", empty password.

- The NixOS installer doesn't do any partitioning or formatting yet,
  so you need to that yourself.  Use "fdisk" and "e2fsck".

- Unpack the NixOS and Nixpkgs sources:

  $ tar xf /nixos.tar.bz2
  $ tar xf /nixpkgs.tar.bz2
  $ ln -s nixpkgs-*/pkgs .

  (TODO: do this automatically.)

- The installation is declarative; you need to make a description of
  the configuration that is to be built and activated.  The
  configuration is specified in a Nix expression.  See
  instances/examples for example machine configurations.  You can copy
  and edit one of those (e.g., instances/examples/basic.nix to
  my-config.nix).  See configuration/options.nix for available
  configuration settings.  The text editor "nano" is available.

  In particular you need to specify boot.rootDevice and
  boot.grubDevice for the devices where the OS and Grub are to be
  installed, respectively.

- Do the installation:

  $ nixos-installer.sh /dev/TARGET . my-config.nix

  where TARGET matched boot.rootDevice in your configuration.  (TODO:
  this should be extracted automatically.)

- If everything went well:

  $ reboot

  You should now be able to boot into the installed NixOS.
  

*** Troubleshooting ***        


To get a Stage 1 shell:

- Add "debug1" to the kernel command line.


To switch to maintenance mode:

  $ shutdown now

To get out of maintenance mode:

  $ initctl emit startup