From 6cbd1c972b26b24c9c5fc39d9f590b0b1aab3c74 Mon Sep 17 00:00:00 2001 From: Gabriel Arazas Date: Tue, 1 Aug 2023 13:32:27 +0800 Subject: [PATCH] docs/site: update description for `systems` on declarative users and images --- .../01-declarative-host-management/index.adoc | 8 ++++++-- .../02-declarative-user-management/index.adoc | 5 +++-- 2 files changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/content/en-US/03-project-specific-setup/01-declarative-host-management/index.adoc b/docs/content/en-US/03-project-specific-setup/01-declarative-host-management/index.adoc index ae2b4ec6..760529d9 100644 --- a/docs/content/en-US/03-project-specific-setup/01-declarative-host-management/index.adoc +++ b/docs/content/en-US/03-project-specific-setup/01-declarative-host-management/index.adoc @@ -22,7 +22,10 @@ The data is then used for certain functions in the flake definition file (i.e., [source, toml] ---- [plover] -system = "x86_64-linux" +systems = [ + "aarch64-linux", + "x86_64-linux", +] format = "iso" hostname = "ploverrific" domain = "foodogsquared.one" @@ -39,8 +42,9 @@ remote-build = true For a complete reference, here are the expected attributes. -- `system` contains the platform of the host system. +- `systems` contains a list of platforms of the host system. This is mainly used to indicate the platform used for the nixpkgs repository. +Take note if `systems` contains more than one platform, the NixOS configurations will be renamed as `$NAME-$SYSTEM` (e.g., `plover` to `plover-x86_64-linux`, `plover-aarch64-linux`). - `format` is the image output format for the host. It expects an accepted value from github:nix-community/nixos-generators[opts=repo] project. diff --git a/docs/content/en-US/03-project-specific-setup/02-declarative-user-management/index.adoc b/docs/content/en-US/03-project-specific-setup/02-declarative-user-management/index.adoc index 195d6248..067b6650 100644 --- a/docs/content/en-US/03-project-specific-setup/02-declarative-user-management/index.adoc +++ b/docs/content/en-US/03-project-specific-setup/02-declarative-user-management/index.adoc @@ -15,7 +15,7 @@ Here's an example user with complete schema. [source, toml] ---- [foo-dogsquared] -system = "x86_64-linux" +systems = [ "x86_64-linux" ] home-manager-channel = "home-manager-23.05" home-directory = "/home/foo-dogsquared" username = "foodogsquared" @@ -30,8 +30,9 @@ magic-rollback = true remote-build = true ---- -- `system` contains the platform of the home-manager user. +- `systems` contains a list of platforms of the home-manager user. This is mainly used to indicate the platform used for the nixpkgs repository. +Take note if there's more than one platforms specified the home environment attribute name will change from `$HOSTNAME` to `$HOSTNAME-$SYSTEM` (e.g., `foo-dogsquared` to `foo-dogsquared-x86_64-linux`). - `home-manager-channel` contains the home-manager channel to be used. The value should be one of the home-manager channel that is imported into this flake.