En Vagrant, una box (o "caja") es una imagen base preempaquetada que contiene un sistema operativo con una configuración mínima, y que sirve como punto de partida para crear máquinas virtuales reproducibles. Vagrant utiliza estas boxes para inicializar entornos de desarrollo en VirtualBox, VMware, Hyper-V o proveedores de nube como AWS.

🧱 ¿Qué es una Box en Vagrant?

Una box es:

  • Una plantilla de máquina virtual.
  • Un archivo que incluye un sistema operativo base (como Ubuntu, CentOS, Debian, etc.).
  • Usada por Vagrant para crear entornos portables y replicables.

Cuando ejecutas vagrant up, Vagrant utiliza la box para crear e iniciar una máquina virtual con la configuración especificada en el Vagrantfile.

Descargar box vagrantup
Descargar box vagrantup

🌍 Descarga de Boxes Oficiales

Vagrant mantiene un repositorio oficial de boxes en: 🔗 https://app.vagrantup.com/boxes/search

Allí puedes buscar y descargar boxes oficiales. Las más comunes incluyen:

  • hashicorp/bionic64 (Ubuntu 18.04)
  • hashicorp/precise64 (Ubuntu 12.04)
  • ubuntu/focal64 (Ubuntu 20.04)
  • debian/bullseye64
  • centos/7

📥 Cómo descargar y usar una box oficial

1️⃣​ Inicializar un proyecto con una box específica

vagrant init ubuntu/focal64

Este comando crea un archivo Vagrantfile con la configuración base para usar la box ubuntu/focal64.

2️⃣​ Levantar la máquina virtual

vagrant up

Este comando:

  • Descarga la box si aún no está en tu sistema.
  • Crea una máquina virtual basada en esa box.
  • Configura red, carpetas compartidas, y otros aspectos definidos en el Vagrantfile.

3️⃣​ Ver boxes descargadas localmente

vagrant box list
Lista de box descargadas
Lista de box descargadas

4️⃣​ Agregar una box manualmente (si ya tienes el archivo .box)

Se explica en el post Creación de box personalizada

vagrant box add my-box /ruta/a/archivo.box

5️⃣ Eliminar una box del sistema

vagrant box remove ubuntu/focal64

✅ Recomendaciones

  • Siempre utiliza boxes oficiales o verificadas para evitar problemas de seguridad.
  • Mantén tus boxes actualizadas: vagrant box update.
  • Puedes personalizar una box y luego convertirla en una nueva con vagrant package.