Every CloudSOE box is versioned. Vagrant reads the versions from the box metadata, so the usual vagrant box commands work as they do with Vagrant Cloud.

How versions are numbered

A version is the build date plus a serial: YYYYMM.DD.N.

202611.14.0 is the first build of 14 November 2026. A second build on the same day would be 202611.14.1. Newer builds always sort higher, so Vagrant can tell which is the latest.

The repository keeps the three newest versions of each box. Older versions are removed.

Pin a version

Without a pin, a new machine uses the newest version you have downloaded. To make a project reproducible, name the build:

Vagrant.configure("2") do |config|
  config.vm.box         = "cloudsoe/ubuntu-24.04"
  config.vm.box_url     = "https://boxes.cloudsoe.com/cloudsoe/ubuntu-24.04.json"
  config.vm.box_version = "202611.14.0"
end

A constraint also works, for example ">= 202611.0.0, < 202701.0.0".

Because only three versions are kept, a pinned version eventually disappears from the repository. Machines that already have the box are not affected. To keep an old build available for new machines, download the .box file from the box page and store it yourself.

Check for and install updates

vagrant box outdated          # is there a newer version?
vagrant box update            # download it
vagrant box prune             # delete old local versions

vagrant box update does not change a machine that already exists. To move a machine to the new box, recreate it:

vagrant destroy
vagrant up

Verify a download

Vagrant checks every download against the SHA-256 in the metadata, and refuses the box if it does not match.

To check a file you downloaded yourself, each .box has a .sha256 file next to it:

curl -LO https://boxes.cloudsoe.com/cloudsoe/boxes/ubuntu-24.04/202611.14.0/ubuntu-24.04-amd64-libvirt.box
curl -LO https://boxes.cloudsoe.com/cloudsoe/boxes/ubuntu-24.04/202611.14.0/ubuntu-24.04-amd64-libvirt.box.sha256
sha256sum -c ubuntu-24.04-amd64-libvirt.box.sha256

The checksum of every version is also listed on its box page.

Add a box without a Vagrantfile

vagrant box add https://boxes.cloudsoe.com/cloudsoe/ubuntu-24.04.json --provider libvirt
vagrant box list