View source for Install NixOS on Online.Net

I've tested this with the Dedibox SC2 and the Dedibox XC, but see no reason for it not to work with all of their configurations.

Start by installing a flavor of Linux (don't care which, since we'll be blowing it away) using the standard Online.net control panel. Make sure the partition layout is as you'd like it, because I'm not including instructions below for changing that.

You don't even need to wait for it to finish booting; click the rescue button on the right and tell it to boot into the ubuntu rescue console. It'll give you a temporary password for the rescue ssh session. Ssh into the rescue image and let's get started!

==Preparation==

=== Be root===

No reason not to be:
<syntaxhighlight lang="bash">
sudo su
cd 
</syntaxhighlight>

=== Create builders ===
<syntaxhighlight lang="bash">
groupadd nixbld
useradd nixbld1
useradd nixbld2
useradd nixbld3
useradd nixbld4
gpasswd -a nixbld1 nixbld
gpasswd -a nixbld2 nixbld
gpasswd -a nixbld3 nixbld
gpasswd -a nixbld4 nixbld
</syntaxhighlight>

=== Add missing packages ===
<syntaxhighlight lang="bash">
apt install bzip2 btrfs-tools
</syntaxhighlight>


===Change the UI language===

All the Online.net images are set to French by default, which I don't want:

<syntaxhighlight lang="bash">
export LANG=POSIX
export LC_ALL=POSIX
</syntaxhighlight>

===Check your partitions===

Now, make sure your partitions are where you expect them, on /dev/sda.

<syntaxhighlight lang="bash">
fdisk -l /dev/sda
</syntaxhighlight>

Here's what mine look like on a Dedibox XC:

<syntaxhighlight lang="bash">
/dev/sda1 *          2048     391167    194560  83 Linux
/dev/sda2          391168 1949523967 974566400  83 Linux
/dev/sda3      1949523968 1953523711   1999872  82 Linux swap / Solaris
</syntaxhighlight>

===Format your partitions===

This will blast away any existing data on your main disk, so make sure you're okay with that.

<syntaxhighlight lang="bash">
mkfs.ext2 /dev/sda1
mkfs.ext4 /dev/sda2 -L nixos

swapoff -a
mkswap /dev/sda3
</syntaxhighlight>

===Mount your freshly minted filesystems===

and mount the new ones we made:

<syntaxhighlight lang="bash">
mount /dev/sda2 /mnt
mkdir /mnt/boot
mount /dev/sda1 /mnt/boot
swapon /dev/sda3
</syntaxhighlight>

==Nix-flavored stuff==

===Get nix onto the rescue system===

We'll need some nix packages to install nix on the target:

<syntaxhighlight lang="bash">
bash <(curl https://nixos.org/nix/install)
. /root/.nix-profile/etc/profile.d/nix.sh
nix-channel --remove nixpkgs
nix-channel --add http://nixos.org/channels/nixos-14.04 nixos
nix-channel --update

cat <<EOF > configuration.nix
{ fileSystems."/" = {};
  boot.loader.grub.enable = false;
} 
EOF

export NIX_PATH=nixpkgs=/root/.nix-defexpr/channels/nixos:nixos=/root/.nix-defexpr/channels/nixos/nixos
export NIXOS_CONFIG=/root/configuration.nix
nix-env -i -A config.system.build.nixos-install -A config.system.build.nixos-option -A config.system.build.nixos-generate-config -f "<nixos>"
</syntaxhighlight>

===Make configuration for your target system===

Generate a default configuration:

<syntaxhighlight lang="bash">
nixos-generate-config --root /mnt
</syntaxhighlight>

This will generate <tt>/mnt/etc/nixos/configuration.nix</tt> and <tt>/mnt/etc/nixos/hardware-configuration.nix</tt>. Eyeball the latter (nano is preinstalled) to make sure the filesystem config looks reasonable and that it's detected your cores correctly. Then customize the former to your liking. By default it'll use DHCP, which didn't seem to work for me on online.net (please tinker and tell me if you got it working with DHCP though), so make sure to customize the network settings if you don't change anything else.

If you need to figure out your current network settings to fill in the gaps in my settings file, try <tt>cat /etc/resolv.conf</tt> and <tt>cat /etc/network/interfaces</tt>.

Here's a sample config from my box:

<syntaxhighlight lang="nix">
{ config, pkgs, ... }:

{
  imports =
    [ # Include the results of the hardware scan.
      ./hardware-configuration.nix
    ];
  
  boot.loader.grub = {
    enable  = true;
    version = 2;
    device  = "/dev/sda";
  };
  
  networking.hostName        = "yourhostname";
  networking.interfaces.eth0 = { ipAddress = "your ip address"; prefixLength = 24; };
  networking.defaultGateway  = "your gateway";
  networking.nameservers     = [ "62.210.16.6" "62.210.16.7" ];

  i18n.defaultLocale = "en_US.UTF-8";

  # environment.systemPackages = with pkgs; [
  #   wget
  # ];

  time.timeZone = "America/New_York";

  services.openssh.enable = true;

  security.sudo.wheelNeedsPassword = false;

  users.extraUsers.youruser = 
    { createHome      = true;
      home            = "/home/youruser";
      description     = "your name";
      extraGroups     = [ "wheel" ];
      useDefaultShell = true;
      openssh.authorizedKeys.keys = [
        "<your pubkey here>"
      ];
    };
}
</syntaxhighlight>

===Actually install the system===

<syntaxhighlight lang="bash">
unset NIXOS_CONFIG
nixos-install
</syntaxhighlight>

That should spend some time downloading and copying stuff around, and then should fail without error. After that, tell the web console to reboot back into normal mode and your machine will be beautifully nixified. Except for the logo stuck on the Online.net console page. Let me know if you figure out how to get rid of that!

==Troubleshooting==

If <tt>nixos-install</tt> fails to download files from the internet, check that your rescue image's <tt>/etc/resolv.conf</tt>is not a symlink. The issue should be fixed now, but at some point the <tt>nixos-install</tt> chroot process would not copy symlinks appropriately, so things would not resolve in the jail.

See [https://github.com/NixOS/nixpkgs/commit/6ebe4a6a523bbab3388453ac119ab08e295a7e06 this commit] for the fix.