# Instalación (Windows) y Configuración de Influx CLI v2.x

## **Instalación nativa (sin Docker)**

{% stepper %}
{% step %}

### **Prepara una carpeta de trabajo**

Crea una carpeta sencilla en cualquier espacio que consideres oportuno, por ejemplo:\
`C:\Users\TU_USUARIO\Desktop\nativa\influxdb2_CLI`
{% endstep %}

{% step %}

### Descargar el CLI de InfluxDB

Abre **PowerShell** como administrador y ejecuta el siguiente comando para descargar el paquete ZIP del CLI (ajusta la versión si lo necesitas):

{% code title="powershell" overflow="wrap" %}

```powershell
wget https://dl.influxdata.com/influxdb/releases/influxdb2-client-2.7.5-windows-amd64.zip -OutFile influxdb2-client-2.7.5-windows-amd64.zip
```

{% endcode %}

Esto descargará el archivo ZIP en el directorio actual.
{% endstep %}

{% step %}

### Extraer los archivos

Extrae el contenido del ZIP en la carpeta, por ejemplo: `C:\Users\TU_USUARIO\Desktop\nativa\influxdb2_CLI\influxdb2-client-2.7.5-windows-amd64`
{% endstep %}

{% step %}

### Verfica la instalación

Inicia el powershell:

{% code title="powershell" overflow="wrap" %}

```powershell
.\influx.exe version
```

{% endcode %}
{% endstep %}

{% step %}

### Añade la carpeta al PATH del sistema

Si quieres poder ejecutar `influx` desde cualquier terminal, añade la carpeta al PATH:

* Pulsa `Win + S`, busca “Variables de entorno” y selecciona “Editar las variables de entorno del sistema”.
* Haz clic en “Variables de entorno…”.
* En “Variables del sistema”, selecciona la variable `Path` y haz clic en “Editar…”.
* Haz clic en “Nuevo” e introduce:

  <pre data-title="text" data-overflow="wrap"><code>C:\Users\TU_USUARIO\Desktop\nativa\influxdb2_CLI\influxdb2-client-2.7.5-windows-amd64
  </code></pre>
* Haz clic en “Aceptar” en todas las ventanas para guardar los cambios.
  {% endstep %}

{% step %}

### Verifica la instalación con el path

Abre una nueva ventana de PowerShell y ejecuta:

{% code title="powershell" overflow="wrap" %}

```powershell
influx version
```

{% endcode %}

Si todo está correcto, verás la versión del CLI instalada.
{% endstep %}

{% step %}

### Acceso a la CLI para consultas con InfluxQL

La Influx CLI v2.x incluye compatibilidad para InfluxQL a través de un modo especial llamado **InfluxQL Shell**.

* Para acceder a este modo, debes usar el comando:

  <pre class="language-powershell" data-title="powershell" data-overflow="wrap"><code class="lang-powershell">influx v1 shell
  </code></pre>

<figure><img src="/files/TOdKPJWzKmJq1LnaxFkT" alt=""><figcaption><p>InfluxQL Shell</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Configuración de Influx CLI v2.x

Estas configuraciones son exclusivas de InfluxDB 2.x. Si deseas utilizar el CLI para consultar InfluxDB 1.x, debes emplear la versión 1.x del CLI. Además, en este caso no es posible almacenar configuraciones, por lo que cada vez que inicies el CLI deberás iniciar sesión con tu usuario y contraseña.

1. **Revisa la configuración inicial de la instalación de InfluxDB 2.x**
2. **Abre una PowerShell en Windows.**
3. **Crea una configuración de conexión con el comando:**

   <pre class="language-powershell" data-title="powershell" data-overflow="wrap"><code class="lang-powershell">influx config create --config-name default --host-url http://localhost:8086 --org TU_ORG --token TU_TOKEN --active
   </code></pre>

   * Reemplaza `TU_ORG` por el nombre de tu organización en InfluxDB.
   * Reemplaza `TU_TOKEN` por tu API Token de acceso. Puedes obtenerlo desde la interfaz web de InfluxDB (UI) en la sección de Tokens.
   * El parámetro `--active` hace que esta configuración sea la predeterminada para todos los comandos futuros del CLI.
4. **Verifica la configuración activa:**

   <pre class="language-powershell" data-title="powershell" data-overflow="wrap"><code class="lang-powershell">influx config list
   </code></pre>

   Deberías ver tu configuración `default` marcada como activa.
5. **A partir de ahora, cualquier comando que uses con el CLI (`influx`) usará por defecto la conexión a `localhost:8086` con los datos proporcionados.**

## **Administrar las configuraciones Influx CLI v2.x**

### **Crear configuraciones**

Usa el comando `influx config create` para crear una nueva configuración:

{% code title="powershell" overflow="wrap" %}

```powershell
influx config create --config-name NOMBRE_CONFIG --host-url http://localhost:8086 --org NOMBRE_ORG --token TU_TOKEN --active
```

{% endcode %}

* `--config-name`: nombre que le das a la configuración.
* `--host-url`: URL del servidor InfluxDB.
* `--org`: nombre de la organización.
* `--token`: token de acceso.
* `--active`: (opcional) la deja como configuración activa por defecto.

***

### **Revisar las configuraciones creadas**

Para listar todas las configuraciones guardadas:

{% code title="powershell" overflow="wrap" %}

```powershell
influx config list
```

{% endcode %}

Esto te mostrará una tabla con todas las configuraciones, indicando cuál está activa.

***

### **Cambiar de configuración**

Para activar otra configuración como la predeterminada:

{% code title="powershell" overflow="wrap" %}

```powershell
influx config NOMBRE_CONFIG
```

{% endcode %}

Esto cambia la configuración activa a la que especifiques.

***

### **Modificar una configuración**

Para cambiar parámetros de una configuración ya existente:

{% code title="powershell" overflow="wrap" %}

```powershell
influx config set --config-name NOMBRE_CONFIG --host-url NUEVO_HOST --org NUEVA_ORG --token NUEVO_TOKEN
```

{% endcode %}

Puedes modificar solo los parámetros que necesites (por ejemplo, solo el token).

***

### **Eliminar una configuración**

Para borrar una configuración específica:

{% code title="powershell" overflow="wrap" %}

```powershell
influx config rm NOMBRE_CONFIG
```

{% endcode %}

Puedes eliminar varias configuraciones a la vez separando los nombres por espacio.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://darioaplicano.gitbook.io/influxdb2.x/instalacion-y-configuracion-inicial/2.-influxdb/instalacion-windows-y-configuracion-de-influx-cli-v2.x.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.