What is HCP Vagrant Registry?

The HCP Vagrant Registry, also referred to as HCP Vagrant, is a public, searchable index of Vagrant boxes that allows box owners to publish and share their Vagrant boxes.

Boxes are the package format for Hashicorp Vagrant environments. A box can be used to bring up an identical working environment on any Vagrant-supported platform.

How does HCP Vagrant work?

HCP Vagrant stores and serves metadata associated with Vagrant Boxes in the form of Vagrant .box files which contain all the required information for a provider to launch a Vagrant machine.

The two primary workflows for HCP Vagrant are Box Discovery and Box Creation & Versioning.

Box Discovery

The HCP Vagrant Discover page makes it easy to find and filter publicly available Vagrant boxes by supported providers and architectures. These are boxes created by both HashiCorp and community contributions. You can find an owner of a box by selecting their username in the URL or clicking on their username in the top left corner of the box page.

Public Vagrant boxes let you get up-and-running quickly in unfamiliar environments. This is a popular way to set a base development environment launchable in a single command within an organization or community.

Box Creation and Versioning

Boxes support versioning so that members of your HCP Organization using Vagrant can update the underlying box easily, and the people who create boxes can push fixes and communicate these fixes efficiently.

HCP Vagrant makes it easy to manage the versioning of boxes. Versioning boxes in HCP Vagrant allows for easy updates, transparent fixes, and clear communication in changes made.

HCP Vagrant and Vagrant Cloud

In December 2022, Vagrant Cloud integrated with HCP Vagrant, delegating new user creation and account management to HCP at that time.

As of May 2024 existing Vagrant Cloud users will have the opportunity to migrate their Vagrant Cloud Organizations to HCP Vagrant in advance of the site-wide migration of Vagrant Cloud to HCP Vagrant.

The Vagrant Team will migrate all existing boxes to HCP Vagrant and retire the current Vagrant Cloud rails app at the end of July 2024. Users who take no action to migrate their boxes will be contacted at the email address associated with their primary Vagrant Cloud organization with instructions on how to claim their boxes in HCP Vagrant.

Migrated organizations will be permanently accessible at their original Vagrant Cloud URLs and won’t require changes to user workflows. Migrated registries will have access to the modern HCP Vagrant UI, an improved search experience, and free private boxes.

Changes from Vagrant Cloud

HCP Vagrant inherits HCP’s resource sharing and access control model and does not support Vagrant Cloud Collaborators.

An HCP Vagrant registry, and any private boxes within that registry, are visible to any HCP user with access to the parent HCP Organization.

As HCP Vagrant it does not support box or registry level access restrictions at this time, paid Vagrant Cloud users who migrate to HCP Vagrant will no longer be charged for their private boxes.

Tiers

HCP Vagrant will launch with a single, standard (free) tier.

Community

Please submit questions, suggestions, and requests to Hashicorp Discuss.