Install NixOS on Rackspace Cloud Servers - Revision history

Klinger: Category:Deployment added

2024-10-26T09:14:14Z

← Older revision		Revision as of 09:14, 26 October 2024
Line 169:		Line 169:

	[[Category:Server]]		[[Category:Server]]
			[[Category:Deployment]]

imported>Nix: add Server category

2021-09-20T04:57:17Z

add Server category

← Older revision		Revision as of 04:57, 20 September 2021
Line 167:		Line 167:

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

			[[Category:Server]]

imported>Fadenb: /* Install some necessary stuff */ use correct syntax highlight language

2017-09-24T12:04:16Z

Install some necessary stuff: use correct syntax highlight language

← Older revision		Revision as of 12:04, 24 September 2017
Line 11:		Line 11:
	You'll need bzip2 later. Also, you'll need to set up some group permissions so NixOS can install properly:		You'll need bzip2 later. Also, you'll need to set up some group permissions so NixOS can install properly:

	<syntaxhighlight lang="~~bash~~">		<syntaxhighlight lang="console">
	$ apt-get update && apt-get install bzip2		$ apt-get update && apt-get install bzip2
	$ addgroup nixbld && adduser --disabled-password nixbld0 && usermod -a -G nixbld nixbld0		$ addgroup nixbld && adduser --disabled-password nixbld0 && usermod -a -G nixbld nixbld0
Line 58:		Line 58:
	and mount the new ones we made:		and mount the new ones we made:

	<syntaxhighlight lang="~~bash~~">		<syntaxhighlight lang="console">
	$ mount /dev/xvdb1 /mnt && mkdir /mnt/boot		$ mount /dev/xvdb1 /mnt && mkdir /mnt/boot
	</syntaxhighlight>		</syntaxhighlight>

imported>Fadenb: Syntax highlighting

2017-08-26T19:58:57Z

Syntax highlighting

← Older revision		Revision as of 19:58, 26 August 2017
Line 11:		Line 11:
	You'll need bzip2 later. Also, you'll need to set up some group permissions so NixOS can install properly:		You'll need bzip2 later. Also, you'll need to set up some group permissions so NixOS can install properly:

	<~~pre~~>		<syntaxhighlight lang="bash">
	$ apt-get update && apt-get install bzip2		$ apt-get update && apt-get install bzip2
	$ addgroup nixbld && adduser --disabled-password nixbld0 && usermod -a -G nixbld nixbld0		$ addgroup nixbld && adduser --disabled-password nixbld0 && usermod -a -G nixbld nixbld0
	</~~pre~~>		</syntaxhighlight>

	The user is temporary; you'll be erasing everything, after all.		The user is temporary; you'll be erasing everything, after all.
Line 28:		Line 28:
	Now, make sure your partitions are where you expect them, on <tt>/dev/xvdb</tt>.		Now, make sure your partitions are where you expect them, on <tt>/dev/xvdb</tt>.

	<~~pre~~>		<syntaxhighlight lang="bash">
	fdisk -l /dev/xvdb		fdisk -l /dev/xvdb
	</~~pre~~>		</syntaxhighlight>

	Here's what mine look like on a 2gb cloud image:		Here's what mine look like on a 2gb cloud image:

	<~~pre~~>		<syntaxhighlight lang="bash">
	Disk /dev/xvdb: 40 GiB, 42949672960 bytes, 83886080 sectors		Disk /dev/xvdb: 40 GiB, 42949672960 bytes, 83886080 sectors
	Units: sectors of 1 * 512 = 512 bytes		Units: sectors of 1 * 512 = 512 bytes
Line 44:		Line 44:
	Device Boot Start End Blocks Id System		Device Boot Start End Blocks Id System
	/dev/xvda1 * 2048 83875364 41936658+ 83 Linux		/dev/xvda1 * 2048 83875364 41936658+ 83 Linux
	</~~pre~~>		</syntaxhighlight>

	===Format your partitions===		===Format your partitions===
Line 50:		Line 50:
	This will blast away any existing data on your main disk, so make sure you're okay with that.		This will blast away any existing data on your main disk, so make sure you're okay with that.

	<~~pre~~>		<syntaxhighlight lang="bash">
	mkfs.ext4 /dev/xvdb1 -L nixos		mkfs.ext4 /dev/xvdb1 -L nixos
	</~~pre~~>		</syntaxhighlight>

	===Mount your freshly minted filesystems===		===Mount your freshly minted filesystems===
Line 58:		Line 58:
	and mount the new ones we made:		and mount the new ones we made:

	<~~pre~~>		<syntaxhighlight lang="bash">
	$ mount /dev/xvdb1 /mnt && mkdir /mnt/boot		$ mount /dev/xvdb1 /mnt && mkdir /mnt/boot
	</~~pre~~>		</syntaxhighlight>

	==Nix-flavored stuff==		==Nix-flavored stuff==
Line 68:		Line 68:
	We'll need some nix packages to install nix on the target:		We'll need some nix packages to install nix on the target:

	<~~pre~~>		<syntaxhighlight lang="bash">
	bash <(curl https://nixos.org/nix/install)		bash <(curl https://nixos.org/nix/install)
	. /root/.nix-profile/etc/profile.d/nix.sh		. /root/.nix-profile/etc/profile.d/nix.sh
Line 84:		Line 84:
	export NIXOS_CONFIG=/root/configuration.nix		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>"		nix-env -i -A config.system.build.nixos-install -A config.system.build.nixos-option -A config.system.build.nixos-generate-config -f "<nixos>"
	</~~pre~~>		</syntaxhighlight>

	===Make configuration for your target system===		===Make configuration for your target system===
Line 90:		Line 90:
	Generate a default configuration:		Generate a default configuration:

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

	This will generate <tt>/mnt/etc/nixos/configuration.nix</tt> and <tt>/mnt/etc/nixos/hardware-configuration.nix</tt>. Eyeball the latter (<tt>nano</tt> 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. You'll need to explicitly set up your networking information accordingly.		This will generate <tt>/mnt/etc/nixos/configuration.nix</tt> and <tt>/mnt/etc/nixos/hardware-configuration.nix</tt>. Eyeball the latter (<tt>nano</tt> 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. You'll need to explicitly set up your networking information accordingly.
Line 100:		Line 100:
	Here's a sample config from my box:		Here's a sample config from my box:

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

Line 145:		Line 145:
	};		};
	}		}
	</~~pre~~>		</syntaxhighlight>

	Note something <b>very important</b>: we set GRUB to install to <tt>/dev/xvdb</tt>, which is the right thing to do when we install <i>from the rescue image</i>. Once we reboot, we need to change this to point back to `/dev/xvda`, in case of GRUB updates.		Note something <b>very important</b>: we set GRUB to install to <tt>/dev/xvdb</tt>, which is the right thing to do when we install <i>from the rescue image</i>. Once we reboot, we need to change this to point back to `/dev/xvda`, in case of GRUB updates.
Line 151:		Line 151:
	===Actually install the system===		===Actually install the system===

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

	That should spend some time downloading and copying stuff around, and then should fail without error. After that, tell the web console to exit rescue mode - your machine will be rebooted, and then you can login to NixOS!		That should spend some time downloading and copying stuff around, and then should fail without error. After that, tell the web console to exit rescue mode - your machine will be rebooted, and then you can login to NixOS!

imported>Fadenb: Created page with "This page is a slightly modified version of the instructions for Online.net, which in turn are based on Install_NixOS_on_Linode|the instructi..."

2017-06-30T11:21:28Z

Created page with "This page is a slightly modified version of the instructions for Online.net, which in turn are based on Install_NixOS_on_Linode|the instructi..."

New page

This page is a slightly modified version of [[Install_NixOS_on_Online.Net|the instructions for Online.net]], which in turn are based on [[Install_NixOS_on_Linode|the instructions for Linode]], and all real credit goes to the authors of that page. I won't bother explaining as much here, so if something is unclear, please refer back to the original page. I've tested this with Rackspace 2GB Perf1 Cloud Servers in Chicago and other regions.

Start by installing a flavor of Linux (don't care which, since we'll be blowing it away) using the standard Rackspace control panel.

Let the image get built. When it's ready, click on the server and boot it into rescue mode. This will give you a temporary password for the rescue image, and then login at the given IP address. The machine is a Debian Jessie image.

==Preparation==

== Install some necessary stuff ==

You'll need bzip2 later. Also, you'll need to set up some group permissions so NixOS can install properly:

<pre>
$ apt-get update && apt-get install bzip2
$ addgroup nixbld && adduser --disabled-password nixbld0 && usermod -a -G nixbld nixbld0
</pre>

The user is temporary; you'll be erasing everything, after all.

===Check your partitions===

Rackspace servers, by default, all come with two drives: a single 'system disk', and a 'data disk'. These are located on separate devices. System disks are designed to be stored as 'machine images', since this is the disk the machine boots off of. We'll ignore the data disk for the rest of this page.

NOTE: 1GB rackspace images do not have a 'data disk' at all. All other Virtual machines come with a data disk.

Normally, your system disk is available under <tt>/dev/xvda</tt>. When you boot into the rescue image though, the disk is `/dev/xvdb`.

Now, make sure your partitions are where you expect them, on <tt>/dev/xvdb</tt>.

<pre>
fdisk -l /dev/xvdb
</pre>

Here's what mine look like on a 2gb cloud image:

<pre>
Disk /dev/xvdb: 40 GiB, 42949672960 bytes, 83886080 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: dos
Disk identifier: 0x0004cdc6

Device Boot Start End Blocks Id System
/dev/xvda1 * 2048 83875364 41936658+ 83 Linux
</pre>

===Format your partitions===

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

<pre>
mkfs.ext4 /dev/xvdb1 -L nixos
</pre>

===Mount your freshly minted filesystems===

and mount the new ones we made:

<pre>
$ mount /dev/xvdb1 /mnt && mkdir /mnt/boot
</pre>

==Nix-flavored stuff==

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

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

<pre>
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-unstable 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>"
</pre>

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

Generate a default configuration:

<pre>
nixos-generate-config --root /mnt
</pre>

This will generate <tt>/mnt/etc/nixos/configuration.nix</tt> and <tt>/mnt/etc/nixos/hardware-configuration.nix</tt>. Eyeball the latter (<tt>nano</tt> 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. You'll need to explicitly set up your networking information accordingly.

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

Here's a sample config from my box:

<pre>
{ config, pkgs, ... }:

{
imports =
[ # Include the results of the hardware scan.
./hardware-configuration.nix
];

# Use the GRUB 2 boot loader.
boot.loader.grub.enable = true;
boot.loader.grub.version = 2;
# Define on which hard drive you want to install Grub.
boot.loader.grub.device = "/dev/xvdb";

networking.hostName = "nixos"; # Define your hostname.
networking.interfaces.eth0 = { ipAddress = "166.78.116.171"; prefixLength = 24; };
networking.defaultGateway = "166.78.116.1";
networking.nameservers = [ "173.203.4.8" "173.203.4.9" ];

time.timeZone = "America/Chicago";

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

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

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>"
];
};
}
</pre>

Note something <b>very important</b>: we set GRUB to install to <tt>/dev/xvdb</tt>, which is the right thing to do when we install <i>from the rescue image</i>. Once we reboot, we need to change this to point back to `/dev/xvda`, in case of GRUB updates.

===Actually install the system===

<pre>
unset NIXOS_CONFIG
nixos-install
</pre>

That should spend some time downloading and copying stuff around, and then should fail without error. After that, tell the web console to exit rescue mode - your machine will be rebooted, and then you can login to NixOS!

===Reboot and fix boot.loader.grub.device===

As mentioned above, after your reboot for the first time, you need to go back to <tt>/etc/nixos/configuration.nix</tt> and make sure <tt>boot.loader.grub.device</tt> is changed to look back at <tt>/dev/xvda</tt> instead. This way your bootloader is properly configured when GRUB may update.

==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.