From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on atuin.qyliss.net X-Spam-Level: X-Spam-Status: No, score=-1.8 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_LOW,RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL,SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=3.4.6 Received: from atuin.qyliss.net (localhost [IPv6:::1]) by atuin.qyliss.net (Postfix) with ESMTP id C23479065A; Mon, 10 Oct 2022 23:33:09 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 496) id 5F250902FB; Mon, 10 Oct 2022 23:32:39 +0000 (UTC) Received: from out4-smtp.messagingengine.com (out4-smtp.messagingengine.com [66.111.4.28]) by atuin.qyliss.net (Postfix) with ESMTPS id E4FB49007E for ; Mon, 10 Oct 2022 23:32:13 +0000 (UTC) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id 5DC0A5C01C0 for ; Mon, 10 Oct 2022 19:32:10 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute1.internal (MEProxy); Mon, 10 Oct 2022 19:32:10 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alyssa.is; h=cc :content-transfer-encoding:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:sender :subject:subject:to:to; s=fm2; t=1665444730; x=1665531130; bh=sz sLtevK8lXONqGzd4VmzQ/9KwqCUAOJYblNyWlB+tI=; b=sOi+q4reueQT66MowC unJUec+I/fwBgSeExVGY7BEM7bGPCUCw2PA5hcRKG8fyFRWBYKSyRmedhSB8y8WY YlLvAnupg0VjgOIDEcvi6bGfn6yolaF5r19TAipVdoZ6EN+1RzGNbd4itgbJAjGB TnEdp9q8f5KtSsavx868kEvqcprU7CjVHycgZ6/tEOhByfmHh0ay3EKRnn074IK2 FsZW1py3j6z6U1xH7SehWTOi/uVNcPL0M5Q7rqgf6JDjmgRrQD66tuIun6K6+K0F 4xx/fc+98y0KtEtiuTZ0XXz2lRtQ4fl5eqMA6Cc+IinzC9Nb9a7jMaxBrowJnVVs sGJQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:sender:subject :subject:to:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; t=1665444730; x=1665531130; bh=szsLtevK8lXON qGzd4VmzQ/9KwqCUAOJYblNyWlB+tI=; b=AiMtK4FKXgkZ0LLo9nblpBmHMLxR5 b07fnClraze432Nr7ZtTDi7ZI8u9KAytimiSkNf7mr6AawQS8EaC0xhaIsaPVJD7 kHsy9ehbsMyOdmirL1qhOIUENVQLYKJdOFcPsl5yJns8LWJ7KOx1u0hnbZIyZmQW 9BaPiF95XrX0O9os3VehCTtKLjvV8NwA3XRFfPVQSp0J4I0/+FVoIDuwjzmkskkD YCOJkq+Snng4+/NBk1BtR1EtO43E5rv8bWe75IM2QnnrE8ICKqJWpZzlxCb9expv AQOveS0N2t+lyyj87KavepE8dO7/OcLtSQ8ahhRunPbKA06aM0LaHgcHQ== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrfeejhedgvddvucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpefhvffufffkofgjfhgggfestdekre dtredttdenucfhrhhomheptehlhihsshgrucftohhsshcuoehhihesrghlhihsshgrrdhi sheqnecuggftrfgrthhtvghrnhepveeiieffgfejueekveevledvtddtueduuedvuddtud ffleeguddtuddvvefhkeevnecuffhomhgrihhnpehnihigohhsrdhorhhgpdhsphgvtght rhhumhdqohhsrdhorhhgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrg hilhhfrhhomhepqhihlhhishhsseigvddvtddrqhihlhhishhsrdhnvght X-ME-Proxy: Feedback-ID: i12284293:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Mon, 10 Oct 2022 19:32:10 -0400 (EDT) Received: by x220.qyliss.net (Postfix, from userid 1000) id 42DFBBC5; Mon, 10 Oct 2022 23:32:07 +0000 (UTC) From: Alyssa Ross To: devel@spectrum-os.org Subject: [PATCH 22/22] Documentation: add how-to guide for Nix-built VMs Date: Mon, 10 Oct 2022 23:29:02 +0000 Message-Id: <20221010232909.1953738-23-hi@alyssa.is> X-Mailer: git-send-email 2.37.1 In-Reply-To: <20221010232909.1953738-1-hi@alyssa.is> References: <20221010232909.1953738-1-hi@alyssa.is> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Message-ID-Hash: RAHD7A7WRRC6VUCYB7IGNZNJ7SV3D2BL X-Message-ID-Hash: RAHD7A7WRRC6VUCYB7IGNZNJ7SV3D2BL X-MailFrom: qyliss@x220.qyliss.net X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-devel.spectrum-os.org-0; header-match-devel.spectrum-os.org-1; header-match-devel.spectrum-os.org-2; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.5 Precedence: list List-Id: Patches and low-level development discussion Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Signed-off-by: Alyssa Ross --- Documentation/nix-vms.adoc | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 Documentation/nix-vms.adoc diff --git a/Documentation/nix-vms.adoc b/Documentation/nix-vms.adoc new file mode 100644 index 0000000..bbfa913 --- /dev/null +++ b/Documentation/nix-vms.adoc @@ -0,0 +1,22 @@ += Managing VMs with Nix +:page-parent: How-to Guides + +// SPDX-FileCopyrightText: 2022 Alyssa Ross +// SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0 + +VMs in a Spectrum system can optionally be managed with +https://nixos.org/[Nix], a functional package manager. + +To create a VM with Nix: + +. Define your VM in vm-config/vms.nix on the +xref:user-partition.adoc[user data partition]. ++ +TIP: Supported settings for VM configuration are documented in +xref:creating-vms.adoc[Creating VMs]. A Nix helper function called +https://spectrum-os.org/git/spectrum/tree/vm-lib/make-vm.nix[`makeVm`] +is provided for creating VM configuration directories with Nix. +. Start the appvm-nix VM (provided by default), and run `vm-rebuild +switch` in its console. +. Reboot the Spectrum host system. (In future, this step will not be +required.) -- 2.37.1