Resolución de errores comunes y troubleshooting en vagrant
Resolución de errores comunes y troubleshooting en vagrant
🛠️ Resolución de errores comunes y troubleshooting en vagrant
🧩 The box 'ubuntu/bionic64' could not be found
Causa: Vagrant no puede encontrar la box especificada.
✅ Solución:
- Verifica que escribiste correctamente el nombre de la box.
- Asegúrate de tener conexión a internet.
- Puedes descargarla manualmente:
vagrant box add ubuntu/bionic64
🔌 SSH connection failed
o Connection refused
Causa: La máquina no está corriendo o no respondió al intento de conexión SSH.
✅ Solución:
- Asegúrate de estar en la carpeta donde está el
Vagrantfile
. - Revisa el estado de la VM:
vagrant status
- Si no está en estado
running
, ejecútala: vagrant up - Si sigue fallando: vagrant reload o fuerza una nueva conexión: vagrant reload --provision
🗂️ No Vagrant environment found in this directory
Causa: Ejecutaste comandos fuera del directorio que contiene el Vagrantfile
.
✅ Solución:
-
Navega al directorio correcto: cd /ruta/a/tu/proyecto
🔒 vagrant ssh
no hace nada o queda colgado
Causa: A veces la conexión SSH tarda o se corrompe.
✅ Solución:
- Detén y reinicia la VM:
vagrant halt vagrant up
- Si sigue fallando, prueba con:
vagrant destroy -f vagrant up
⚠️ Esto eliminará la VM y la recreará (no afecta tus archivos del host).
🗝️ Permission denied (publickey)
al hacer SSH manual
Causa: Intentas conectarte por SSH sin usar la llave que Vagrant genera.
✅ Solución:
Usa: vagrant ssh
O configura el SSH manual con vagrant ssh-config
Y luego: ssh -i .vagrant/machines/default/virtualbox/private_key vagrant@127.0.0.1 -p 2222
📦 Errores de synced_folder
o permisos
Causa: La carpeta del host no se puede montar dentro de la VM.
✅ Solución:
- Verifica que la ruta de la carpeta exista.
- En Windows, ejecuta el terminal como administrador.
- Usa rutas absolutas si tienes problemas con rutas relativas.
config.vm.synced_folder "C:/miProyecto", "/vagrant"
🧹 La máquina virtual se comporta extraño o está corrupta
✅ Solución:
- Detén y elimina la VM:
vagrant halt vagrant destroy -f
- Borra el archivo
.vagrant/
si existe. - Luego vuelve a levantarla:
vagrant up
🧰 Comandos útiles de diagnostico
Comando | Qué hace |
---|---|
vagrant status |
Muestra el estado actual de la VM |
vagrant ssh-config |
Muestra detalles de conexión SSH |
vagrant global-status |
Lista todas las VMs de todos los proyectos |
vagrant up --debug |
Ejecuta con salida detallada para depuración |
vagrant reload --provision |
Reinicia y reaplica configuración y scripts |
✅ Consejos generales
- Siempre ejecuta los comandos desde la carpeta con el
Vagrantfile
. - No edites la VM directamente desde VirtualBox; hazlo desde Vagrant.
- Asegúrate de que VirtualBox esté actualizado.
- Si usas Windows, usa Git Bash, PowerShell o WSL para mayor compatibilidad.