Primeros comandos en vagrant
Explicaremos los comandos de vagrant init, vagrant up, vagrant halt, vagrant destroy y realizaremos ejemplos
Vagrant es una herramienta para la creación y configuración de entornos de desarrollo virtualizados. En este artículo, señalaré cinco comandos que todo usuario de Vagrant necesita saber.
Antes de iniciar
Recomiendo que leas los siguientes post en donde explicamos los conceptos básicos de vagrant.
- ¿Qué es Vagrant? ¿Por qué usarlo? Comparación con Docker y VirtualBox.
- Instalación de Vagrant y VirtualBox en Windows/Linux/macOS.
- Ingresa al repositorio oficial de boxes de vagrant para buscar el box de S.O. que desees trabajar.
🛠️ Primeros comandos en Vagrant
Cuando empiezas a trabajar con Vagrant, hay algunos comandos esenciales que debes conocer. Son los pilares para levantar, detener y eliminar máquinas virtuales fácilmente desde tu terminal.
📦 vagrant init
Este comando se utiliza para crear un archivo llamado Vagrantfile
, que es el archivo de configuración principal de Vagrant. Aquí defines el sistema operativo que usarás, la configuración de red, la carpeta compartida, etc. Puede revisar mas informacion en la documentación oficial https://developer.hashicorp.com/vagrant/docs/cli/init
Expliquemos el funcionamiento con varios ejemplos, pero antes, la siguiente es la sintaxis del comando.
vagrant init [nombre_de_la_box]
¿Qué hace?
-
Crea un archivo
Vagrantfile
en el directorio actual. -
En ese archivo se configura la "box" base: en este caso, [nombre_de_la_box] puede ser reemplazado con: bento/ubuntu-24.04.
Ejemplos:
vagrant init bento/ubuntu-24.04

🚀 vagrant up
Este comando arranca y provisiona la máquina virtual según lo definido en el Vagrantfile
.
Este es el comando más importante en Vagrant, ya que es así como se crea cualquier máquina Vagrant.
En la documentación oficial https://developer.hashicorp.com/vagrant/docs/cli/up encontrará mas información, a continuación, realizaremos revisaremos su sintaxis:
vagrant up
¿Qué hace?
-
Descarga la box (si no está descargada).
-
Crea y enciende una nueva máquina virtual.
-
Configura red, carpetas compartidas y aprovisionamiento si lo has definido.

📴 vagrant halt
Detiene la máquina virtual de forma ordenada (como si apagaras una computadora correctamente). Mas información en https://developer.hashicorp.com/vagrant/docs/cli/halt.
Vagrant primero intentará apagar la máquina correctamente ejecutando el mecanismo de apagado del sistema operativo invitado. Si esto falla, o si --forcese especifica la opción, Vagrant simplemente cortará la alimentación de la máquina.
vagrant halt
¿Qué hace?
-
Apaga la máquina virtual que está corriendo.
💣 vagrant destroy
Destruye por completo la máquina virtual creada por Vagrant. Se borra la VM, pero NO el Vagrantfile
, por lo que puedes recrearla con vagrant up
. https://developer.hashicorp.com/vagrant/docs/cli/destroy
vagrant destroy
¿Qué hace?
-
Elimina la máquina virtual del sistema.
-
Libera espacio en disco.
🧠 Tip adicional
Puedes ejecutar estos comandos en orden para entender el ciclo de vida de una VM en Vagrant:
vagrant init hashicorp/bionic64
Crear archivo de configuración vagrant up # Encender y configurar la máquina vagrant halt # Detenerla vagrant destroy # Borrarla completamente
✅ Resumen visual
Comando | ¿Qué hace? | ¿Se puede revertir? |
---|---|---|
vagrant init |
Crea el Vagrantfile (configuración) | Sí |
vagrant up |
Inicia y configura la máquina virtual | Sí (vagrant halt ) |
vagrant halt |
Detiene la máquina | Sí (vagrant up ) |
vagrant destroy |
Elimina la máquina virtual | No |