summary refs log tree commit diff
diff options
context:
space:
mode:
authorJörg Thalheim <joerg@thalheim.io>2018-11-23 15:40:10 +0000
committerJörg Thalheim <joerg@thalheim.io>2018-11-23 15:40:10 +0000
commit50daffc4b828894e076c190fbd88bac19148b4f0 (patch)
tree03f77b75dcf4205246cc1f82e3a8a83296c8cd5f
parentceececbd0404d180b34d1eecfcd4cea728fb1f4a (diff)
downloadnixpkgs-50daffc4b828894e076c190fbd88bac19148b4f0.tar
nixpkgs-50daffc4b828894e076c190fbd88bac19148b4f0.tar.gz
nixpkgs-50daffc4b828894e076c190fbd88bac19148b4f0.tar.bz2
nixpkgs-50daffc4b828894e076c190fbd88bac19148b4f0.tar.lz
nixpkgs-50daffc4b828894e076c190fbd88bac19148b4f0.tar.xz
nixpkgs-50daffc4b828894e076c190fbd88bac19148b4f0.tar.zst
nixpkgs-50daffc4b828894e076c190fbd88bac19148b4f0.zip
nixos/docker-image: add example usage
-rw-r--r--nixos/modules/virtualisation/docker-image.nix38
1 files changed, 38 insertions, 0 deletions
diff --git a/nixos/modules/virtualisation/docker-image.nix b/nixos/modules/virtualisation/docker-image.nix
index 2f304094d55..baac3a35a78 100644
--- a/nixos/modules/virtualisation/docker-image.nix
+++ b/nixos/modules/virtualisation/docker-image.nix
@@ -17,3 +17,41 @@
   # Socket activated ssh presents problem in Docker.
   services.openssh.startWhenNeeded = false;
 }
+
+# Example usage:
+#
+## default.nix
+# let
+#   nixos = import <nixpkgs/nixos> {
+#     configuration = ./configuration.nix;
+#     system = "x86_64-linux";
+#   };
+# in
+# nixos.config.system.build.tarball
+#
+## configuration.nix
+# { pkgs, config, lib, ... }:
+# {
+#   imports = [
+#     <nixpkgs/nixos/modules/virtualisation/docker-image.nix>
+#     <nixpkgs/nixos/modules/installer/cd-dvd/channel.nix>
+#   ];
+#
+#   documentation.doc.enable = false;
+#
+#   environment.systemPackages = with pkgs; [
+#     bashInteractive
+#     cacert
+#     nix
+#   ];
+# }
+#
+## Run
+# Build the tarball:
+# $ nix-build default.nix
+# Load into docker:
+# $ docker import result/tarball/nixos-system-*.tar.xz nixos-docker
+# Boots into systemd
+# $ docker run --privileged -it nixos-docker /init
+# Log into the container
+# $ docker exec -it <container-name> /run/current-system/sw/bin/bash