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.
🌍 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/bullseye64centos/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
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.