Problemas comunes
Soluciona problemas comunes de instalación y ejecución de Dropstone CLI. Soluciones paso a paso para instalaciones fallidas, problemas de autenticación y errores de actualización.
Los problemas más comunes que encuentran los usuarios de Dropstone, con los pasos para solucionarlos. Para errores de ejecución y depuración por función, consulta la página de solución de problemas de CLI.
La instalación falla en macOS
"Command not found: brew"
Primero necesitas Homebrew. Instálalo una vez:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
En Apple Silicon, también añade Homebrew a tu PATH:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
Luego vuelve a ejecutar la instalación de Dropstone:
brew tap blankline-org/dropstone-cli
brew install dropstone
"Cannot install: package already exists"
Sobrescribe por la fuerza la instalación existente:
brew uninstall dropstone
brew install dropstone
El tap de Homebrew no se actualiza
Limpia la caché y vuelve a hacer el tap:
brew untap blankline-org/dropstone-cli
brew cleanup
brew tap blankline-org/dropstone-cli
brew install dropstone
"zsh: killed" al ejecutar dropstone
La versión 1.0.50 para Apple Silicon no podía iniciarse en macOS 27 — macOS lo detenía antes de que imprimiera nada, por lo que dropstone --version y dropstone upgrade también se detenían. Reinstalar lo soluciona; los comandos están en Detenido al iniciar en macOS.
La instalación falla en Windows
"irm is not recognized as an internal or external command"
Estás en CMD, no en PowerShell. Cambia a PowerShell:
irm https://dropstone.io/install.ps1 | iex
O usa el instalador de CMD:
curl -fsSL https://dropstone.io/install.cmd -o install.cmd && install.cmd
"The token '&&' is not a valid statement separator"
Estás en PowerShell intentando ejecutar el comando de CMD. Cambia al comando de PowerShell de arriba.
La actualización pendiente no se aplicó
Si dropstone update informó éxito pero dropstone --version aún muestra la versión anterior, reinicia tu terminal. En Windows, el nuevo binario se intercambia en el siguiente inicio.
Si eso no ayuda, fuerza la reinstalación:
irm https://dropstone.io/install.ps1 | iex
Autenticación
"Failed to sign in"
- Ejecuta
dropstonede nuevo. En el primer inicio, abre dropstone.io/login para el inicio de sesión basado en PKCE. - Si el flujo del navegador falla, pega un token en su lugar. Obtén uno en dropstone.io/account y elige "Paste a token" en el mensaje de inicio de sesión.
"Session expired"
Ejecuta /login desde dentro de Dropstone para actualizar tus credenciales.
Atascado en la cuenta incorrecta
Para cambiar de cuenta, ejecuta /login desde dentro de Dropstone y elige la cuenta correcta en el mensaje del navegador.
Problemas de actualización
dropstone update informa "Update Available" pero no hace nada
Esto suele significar que el instalador automático no tiene acceso de escritura al directorio del binario. Reinstala usando tu método original:
| Plataforma | Comando |
|---|---|
| macOS (Homebrew) | brew upgrade dropstone |
| macOS / Linux (script) | curl -fsSL https://dropstone.io/install | bash |
| Windows (PowerShell) | irm https://dropstone.io/install.ps1 | iex |
Atascado en una versión anterior
Comprueba qué está instalado:
dropstone --version
Compáralo con la última versión en download.dropstone.io/latest.txt. Si no coinciden, reinstala usando el comando de la plataforma de arriba.
¿Aún tienes problemas?
Si nada de lo anterior resolvió tu problema, consulta la página más detallada de solución de problemas de CLI, o abre un issue en dropstone.io/contact con:
- Tu sistema operativo y versión
- La salida de
dropstone --version - El mensaje de error completo y el comando exacto que ejecutaste