Skip to content

Commit 9770e6a

Browse files
committed
docs: update with new image
Add info about new packer utm cloud builder
1 parent 3aaeec6 commit 9770e6a

File tree

4 files changed

+23
-17
lines changed

4 files changed

+23
-17
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ vagrant plugin install vagrant_utm
1515

1616
```ruby
1717
Vagrant.configure("2") do |config|
18-
config.vm.box = "utm/debian11"
18+
config.vm.box = "utm/bookworm"
1919
end
2020
```
2121

docs/boxes/creating_utm_box.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -60,17 +60,18 @@ Check the [UTM Guide on Guest Support](https://docs.getutm.app/guest-support/gue
6060

6161
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.
6262

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).
6464
The packer plugin has the following components:
6565
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
6869
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.
7172

7273

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.
7475

7576
## Using your own UTM VMs
7677

docs/boxes/utm_box_gallery.md

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,22 +10,27 @@ nav_order: 1
1010
To work with Vagrant, a base VM (box) must have
1111
[certain features](https://developer.hashicorp.com/vagrant/docs/boxes/base), like an ssh user for vagrant to connect.
1212

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).
1414

1515
{: .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.
1717

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:
1924
```ruby
2025
config.vm.box = "utm/debian11"
2126
```
2227

23-
* Ubuntu 24.04 :
28+
* Ubuntu 24.04 - Built from ISO:
2429
```ruby
2530
config.vm.box = "utm/ubuntu-24.04"
2631
```
2732

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]
2934
<!-- * ArchLinux ARM -->
3035

3136

docs/index.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -59,14 +59,14 @@ vagrant plugin install vagrant_utm
5959
Option 1: Create a Vagrantfile and initiate the box (OR)
6060

6161
```
62-
vagrant init utm/debian11
62+
vagrant init utm/bookworm
6363
```
6464

6565
Option 2: Open the Vagrantfile and replace the contents with the following
6666

6767
```ruby
6868
Vagrant.configure("2") do |config|
69-
config.vm.box = "utm/debian11"
69+
config.vm.box = "utm/bookworm"
7070
end
7171
```
7272

@@ -81,9 +81,9 @@ Now start using your machine!
8181

8282
`vagrant ssh` to log into machine or forward ports to check your website or share folders and start developing.
8383

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!
8787

8888
## About the project
8989

0 commit comments

Comments
 (0)