From 58c42bdf690dcf8f9fa2bacf899af0f536c8a5d3 Mon Sep 17 00:00:00 2001
From: dusikasss <126321909+dusikasss@users.noreply.github.com>
Date: Fri, 8 Mar 2024 17:51:23 +0300
Subject: [PATCH] Create Developer-Guide_Building-with-Multipass.md (#392)

Description of Building with Docker
---
 ...Developer-Guide_Building-with-Multipass.md | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 docs/Developer-Guide_Building-with-Multipass.md

diff --git a/docs/Developer-Guide_Building-with-Multipass.md b/docs/Developer-Guide_Building-with-Multipass.md
new file mode 100644
index 00000000..e9c44b57
--- /dev/null
+++ b/docs/Developer-Guide_Building-with-Multipass.md
@@ -0,0 +1,48 @@
+# Building with Multipass
+
+In order to build an Armbian image from scratch, whether for development purposes or to [apply user customizations](https://docs.armbian.com/Developer-Guide_User-Configurations/) on top of a base image, a build environment is required. Per the Armbian documentation, Ubuntu 22.04 is [the officially supported](https://docs.armbian.com/Developer-Guide_Build-Preparation/) build platform. 
+
+[Multipass](https://multipass.run/) that is designed for quick and painless provisioning of Ubuntu VMs.
+
+
+### Creating a VM and preparing for build
+
+Multipass is [available](https://multipass.run/install) for macOS, Windows and Linux platforms.
+
+Once you have multipass installed, a Jammy (22.04) instance with 4 CPUs, 4GB of RAM and 25GB of space available can be provisioned with a single command:
+
+```bash
+multipass launch --cpus 4 --disk 25G --mem 4G --name jammy
+```
+
+### Clone the build repo
+
+You can run commands direct on the instance to clone the build repo:
+
+```bash
+multipass exec jammy -- bash -c "git clone --depth 1 https://github.com/armbian/build" 
+```
+
+### Use an instance
+Then you can get a shell to the instance and run the build as needed:
+
+```bash
+C:\> multipass shell armbian
+Welcome to Ubuntu 22.04.1 LTS (GNU/Linux 5.4.0-48-generic x86_64)
+Last login: Tue Jan 30 12:23:08 2024 from 172.22.111.1
+# Let's get building!  
+ubuntu@armbian:~$ cd build
+ubuntu@armbian:~/build$ ./compile.sh BOARD=orangepizero ... etc
+```
+
+### Share data with an instance
+
+The recommended way to share data between your host and an instance with Multipass is the command:mount
+```bash
+multipass mount /my/dir jammy
+multipass info jammy
+```
+
+Mounts:         /my/dir => /my/dir
+
+From this point on will be available inside the instance./my/dir