You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/boxes/creating_utm_box.md
+7-6Lines changed: 7 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -60,17 +60,18 @@ Check the [UTM Guide on Guest Support](https://docs.getutm.app/guest-support/gue
60
60
61
61
By satisfying the [general guidance on creating vagrant boxes](https://developer.hashicorp.com/vagrant/docs/boxes/base) and the above [Virtual Machine](#virtual-machine) requirements you can use your VM with Vagrant UTM plugin.
62
62
63
-
Apart from manually building the boxes, you can also use the semi-automated way of building these boxes using [packer plugin for UTM](https://github.com/naveenrajm7/packer-plugin-utm).
63
+
Apart from manually building the boxes, you can also use the automated (almost) way of building these boxes using [packer plugin for UTM](https://github.com/naveenrajm7/packer-plugin-utm).
64
64
The packer plugin has the following components:
65
65
1. Builder
66
-
1. UTM - Use existing utm file
67
-
2. ISO - Start from scratch using ISO files
66
+
1. UTM - Use existing utm file
67
+
2. ISO - Start from scratch using ISO files
68
+
3. CLOUD - Use existing qcow2 cloud images
68
69
2. Post-processor
69
-
1. ZIP - Package UTM VM into zip file
70
-
2. Vagrant - Package UTM VM into vagrant box.
70
+
1. ZIP - Package UTM VM into zip file
71
+
2. Vagrant - Package UTM VM into vagrant box.
71
72
72
73
73
-
Checkout [UTM Box Guide](https://github.com/naveenrajm7/utm-box/blob/main/HowToBuild/DebianUTM.md) to know how to build Box using packer.
74
+
Checkout [UTM Box Packer recipe](https://github.com/naveenrajm7/utm-box?tab=readme-ov-file#building-boxes) to know how to build Box using packer.
Copy file name to clipboardExpand all lines: docs/boxes/utm_box_gallery.md
+10-5Lines changed: 10 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -10,22 +10,27 @@ nav_order: 1
10
10
To work with Vagrant, a base VM (box) must have
11
11
[certain features](https://developer.hashicorp.com/vagrant/docs/boxes/base), like an ssh user for vagrant to connect.
12
12
13
-
To help you get started with Vagrant UTM provider, a couple of pre-built VMs that work with Vagrant and are published in [HCP Vagrant registry](https://portal.cloud.hashicorp.com/vagrant/discover/utm).
13
+
To help you get started with Vagrant UTM provider, some pre-built VMs that work with Vagrant are published in [HCP Vagrant registry](https://portal.cloud.hashicorp.com/vagrant/discover/utm).
14
14
15
15
{: .important}
16
-
All the VMs provided are built from [UTM Gallery VMs](https://mac.getutm.app/gallery/)or ISO in an (semi) automated way using [packer plugin for UTM][packer plugin for UTM]. Please see the [UTM Box Guide][UTM Box Guide] on how these UTM Vagrant boxes were built using packer.
16
+
All the VMs provided are built from Cloud Images or ISO files in an (semi) automated way using [packer plugin for UTM][packer plugin for UTM]. Please see the [UTM Box Guide][UTM Box Guide] on how these UTM Vagrant boxes were built using packer.
17
17
18
-
* Debian 11 (Xfce):
18
+
* Debian 12 - Built from cloud image:
19
+
```ruby
20
+
config.vm.box ="utm/bookworm"
21
+
```
22
+
23
+
* Debian 11 (Xfce) - Built from UTM file of UTM gallery:
19
24
```ruby
20
25
config.vm.box ="utm/debian11"
21
26
```
22
27
23
-
* Ubuntu 24.04 :
28
+
* Ubuntu 24.04 - Built from ISO:
24
29
```ruby
25
30
config.vm.box ="utm/ubuntu-24.04"
26
31
```
27
32
28
-
*Help build more boxes using [packer plugin for UTM][packer plugin for UTM]
33
+
*Build your own boxes using [packer plugin for UTM][packer plugin for UTM]
Option 1: Create a Vagrantfile and initiate the box (OR)
60
60
61
61
```
62
-
vagrant init utm/debian11
62
+
vagrant init utm/bookworm
63
63
```
64
64
65
65
Option 2: Open the Vagrantfile and replace the contents with the following
66
66
67
67
```ruby
68
68
Vagrant.configure("2") do |config|
69
-
config.vm.box ="utm/debian11"
69
+
config.vm.box ="utm/bookworm"
70
70
end
71
71
```
72
72
@@ -81,9 +81,9 @@ Now start using your machine!
81
81
82
82
`vagrant ssh` to log into machine or forward ports to check your website or share folders and start developing.
83
83
84
-
Check [Commands](commands.md) for all supported Vagrant commands.
85
-
Check [Configuration](configuration.md) for more UTM provider config options.
86
-
84
+
Check [Commands](commands.md) for all supported Vagrant commands.
85
+
Check [Configuration](configuration.md) for more UTM provider config options.
86
+
Discover UTM Vagrant boxes at [HCP Vagrant UTM Registry](https://portal.cloud.hashicorp.com/vagrant/discover/utm), which as boxes of popular OS including OpenBSD!
0 commit comments