Skip to content

volta setup

El comando volta setup habilitará Volta modificando el PATH para el usuario actual (de una manera dependiente de la plataforma) para incluir el directorio shim de Volta. Tiene la siguiente sintaxis:

bash
Habilita Volta para el usuario actual

USO:
    volta setup [FLAGS]

FLAGS:
        --verbose    Habilita diagnósticos verbosos
        --quiet      Previene salida innecesaria
    -h, --help       Imprime información de ayuda

Configuración Unix

En sistemas Unix (macOS y Linux), volta setup buscará scripts de perfil usando la siguiente lista:

  • ~/.profile
  • ~/.bash_profile
  • ~/.bashrc
  • ~/.zshrc
  • ~/.config/fish/config.fish
  • El valor de la variable de entorno PROFILE

Para cada uno de estos archivos que existan, volta setup los modificará para incluir líneas que:

  1. Definan la variable de entorno VOLTA_HOME (típicamente establecida a ~/.volta)
  2. Añadan $VOLTA_HOME/bin a la variable de entorno PATH

Si el archivo de configuración para tu shell actual (detectado usando la variable de entorno $SHELL) no existe, será creado con los contenidos apropiados, si es posible.

Configuración Windows

En Windows, volta setup modificará la variable de entorno Path del Usuario para incluir el directorio shim (%LOCALAPPDATA%\Volta\bin). Esto asegura que los comandos de Volta estén disponibles en todos los símbolos del sistema.

Ejemplos

Configuración Básica

bash
# Ejecutar el proceso de configuración
volta setup

Esto actualizará tus archivos de perfil de shell y hará Volta disponible en tu shell.

Configuración Silenciosa

bash
# Ejecutar configuración con salida mínima
volta setup --quiet

Cuándo Usar

El comando volta setup es útil en varios escenarios:

  1. Después de una Instalación Nueva: Ejecutar después de instalar Volta por primera vez
  2. Después de Eliminar Configuración de Shell: Si has editado manualmente tu perfil de shell y eliminado la configuración de Volta
  3. Para Nuevos Usuarios: Al configurar Volta para un nuevo usuario en un sistema
  4. Después de Cambios de Shell: Si has cambiado a un shell diferente

Qué Añade la Configuración a Tu Perfil

Para bash/zsh/sh, volta setup añade líneas similares a:

bash
export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"

Para shell fish, añade:

fish
set -gx VOLTA_HOME "$HOME/.volta"
set -gx PATH "$VOLTA_HOME/bin" $PATH

Configuración Manual

Si prefieres no usar volta setup, puedes añadir manualmente Volta a tu PATH:

  1. Crear el directorio home de Volta (por defecto ~/.volta en Unix o %LOCALAPPDATA%\Volta en Windows)
  2. Añadir el directorio bin a tu variable de entorno PATH
  3. Recargar tu shell o reiniciar tu terminal

Solución de Problemas

Si Volta no está disponible después de ejecutar volta setup:

  1. Asegúrate de haber abierto una nueva ventana de terminal
  2. Verifica que el directorio bin de Volta esté en tu PATH (echo $PATH en Unix o echo %PATH% en Windows)
  3. Verifica que el directorio home de Volta exista
  4. Para sistemas Unix, verifica que tu perfil de shell fue modificado correctamente