> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/cli/es/referencia/commands/sign-in-and-contexts.md).

# Comandos de inicio de sesión y de contexto

Cada opción de devo login, logout, status, info y de los comandos devo context, con los valores predeterminados, los valores permitidos y las reglas que comprueba Devolutions CLI.

Esta página enumera cada argumento y cada opción de los comandos que guardan, seleccionan e inspeccionan sus espacios de trabajo: `devo login`, `devo logout`, `devo status`, `devo info` y `devo context`. Para una visión de todos los comandos, consulte [Comandos](/cli/es/referencia/commands.md). Para una ayuda paso a paso, consulte [Iniciar sesión en Devolutions Cloud](/cli/es/guias/connect/devolutions-cloud.md), [Iniciar sesión en Devolutions Server](/cli/es/guias/connect/devolutions-server.md), [Usar un perfil local de Devolutions Remote Desktop Manager](/cli/es/guias/connect/local-profile.md) y [Cambiar entre espacios de trabajo](/cli/es/guias/connect/switch-workspaces.md).

Las opciones que acepta cada comando, como `--context`, `--source` o `--output json`, están en [Opciones globales](/cli/es/referencia/global-options.md).

{% hint style="info" %}
Un **contexto** es un espacio de trabajo guardado: un inicio de sesión de Devolutions Cloud, un inicio de sesión de Devolutions Server o un perfil local. Los nombres de contexto se comparan sin distinguir mayúsculas, así que `Prod` y `prod` son el mismo contexto.
{% endhint %}

## devo login

Guarda un espacio de trabajo como contexto: inicia sesión en Devolutions Cloud o Devolutions Server, o apunta a la carpeta de un perfil local de Devolutions Remote Desktop Manager. El contexto nuevo pasa a ser el actual, a menos que añada `--no-set-current`.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

```bash
devo login <name> --cloud <url> --oauth
devo login <name> --cloud <url> --application-key <key> --application-secret-env <variable>
devo login <name> --server <url> --api-key-env <variable>
devo login <name> --server <url> --username <username> --password-env <variable>
devo login <name> --sqlite <folder>
```

Pase exactamente uno de `--cloud`, `--server` o `--sqlite`. Sin ninguno de ellos, o con más de uno, el comando se detiene antes de contactar con nada.

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Nombre del contexto que se va a crear. Obligatorio. No puede estar vacío. No puede ser un nombre ya usado por un contexto de otro tipo: elija otro nombre, o elimine primero el otro contexto.</td></tr><tr><td><code>--cloud &#x3C;url></code></td><td></td><td>Dirección de Devolutions Cloud, por ejemplo <code>https://example.devolutions.app</code>. Debe ser una dirección <code>https</code> absoluta sin nombre de usuario ni contraseña; el <code>http</code> simple solo se acepta para una dirección de bucle invertido como <code>localhost</code>. Iniciar sesión de nuevo con el nombre de un contexto existente de Devolutions Cloud lo sustituye.</td></tr><tr><td><code>--server &#x3C;url></code></td><td></td><td>Dirección de Devolutions Server. Las mismas reglas que <code>--cloud</code>: dirección <code>https</code> absoluta, <code>http</code> solo para una dirección de bucle local, sin nombre de usuario ni contraseña.</td></tr><tr><td><code>--sqlite &#x3C;folder></code></td><td></td><td>Carpeta del perfil local de Devolutions Remote Desktop Manager que contiene el espacio de trabajo SQLite. Las variables de entorno de la ruta se expanden. No se inicia sesión: el contexto solo apunta a la carpeta. Las opciones de inicio de sesión de abajo se ignoran con <code>--sqlite</code>.</td></tr><tr><td><code>--oauth</code></td><td>Desactivado</td><td>Devolutions Cloud o Devolutions Server: inicia sesión por su navegador. Devolutions CLI imprime la dirección de inicio de sesión en la salida de error cada vez, por si el navegador no se abre. Usa una redirección del navegador local, salvo que añada <code>--use-device-code</code>. No se puede combinar con las opciones de clave de aplicación (Devolutions Cloud), ni con una clave de API, un nombre de usuario, una contraseña, un dominio o una opción de usuario de aplicación (Devolutions Server).</td></tr><tr><td><code>--use-device-code</code></td><td>Desactivado</td><td>Solo con <code>--oauth</code>: inicia sesión con un código de dispositivo en lugar de la redirección del navegador local, para un ordenador sin navegador. Definir la variable de entorno <code>DEVO_CLI_USE_DEVICE_CODE</code> tiene el mismo efecto. Con Devolutions Cloud, un inicio de sesión con código de dispositivo no obtiene una clave de cuenta, así que solo funcionan <code>devo status</code> y <code>devo logout</code>: inicie sesión sin <code>--use-device-code</code> para un acceso completo. Se rechaza sin <code>--oauth</code>.</td></tr><tr><td><code>--application-key &#x3C;key></code> (<code>--app-key</code>)</td><td></td><td>Solo Devolutions Cloud: clave de aplicación. Obligatoria para un inicio de sesión de Devolutions Cloud sin <code>--oauth</code>. No puede contener caracteres de control. Rechazada con <code>--oauth</code> y con <code>--server</code>.</td></tr><tr><td><code>--application-secret-env &#x3C;variable></code> (<code>--app-secret-env</code>)</td><td></td><td>Solo Devolutions Cloud: nombre de la variable de entorno que contiene el secreto de la aplicación. Use esta opción o <code>--application-secret-file</code>, no ambas. La variable debe existir y su valor no puede estar vacío.</td></tr><tr><td><code>--application-secret-file &#x3C;path></code> (<code>--app-secret-file</code>)</td><td></td><td>Solo Devolutions Cloud: archivo que contiene el secreto de aplicación. Los saltos de línea al final del archivo se ignoran.</td></tr><tr><td><code>--api-key-env &#x3C;variable></code></td><td></td><td>Solo Devolutions Server: nombre de la variable de entorno que contiene la clave de API. Use esta opción o <code>--api-key-file</code>, no ambas. No se puede combinar con <code>--username</code>, una opción de contraseña, <code>--domain-id</code> o <code>--as-application</code>.</td></tr><tr><td><code>--api-key-file &#x3C;path></code></td><td></td><td>Solo Devolutions Server: archivo que contiene la clave de API.</td></tr><tr><td><code>--username &#x3C;username></code></td><td></td><td>Solo Devolutions Server: nombre de usuario, para el inicio de sesión con nombre de usuario y contraseña. Necesita <code>--password-env</code> o <code>--password-file</code>.</td></tr><tr><td><code>--password-env &#x3C;variable></code></td><td></td><td>Solo Devolutions Server: nombre de la variable de entorno que contiene la contraseña. Use esta opción o <code>--password-file</code>, no ambas. Necesita <code>--username</code>.</td></tr><tr><td><code>--password-file &#x3C;path></code></td><td></td><td>Solo Devolutions Server: archivo que contiene la contraseña. Necesita <code>--username</code>.</td></tr><tr><td><code>--windows-auth</code></td><td>Desactivado</td><td>Solo Devolutions Server: inicia sesión con la autenticación de Windows. Funciona solo en Windows. No se puede combinar con <code>--username</code>, una opción de contraseña, <code>--domain-id</code> o <code>--as-application</code>.</td></tr><tr><td><code>--as-application</code></td><td>Desactivado</td><td>Solo Devolutions Server: con <code>--username</code> y una opción de contraseña, inicia sesión como usuario de aplicación.</td></tr><tr><td><code>--domain-id &#x3C;id></code></td><td></td><td>Solo Devolutions Server: identificador de dominio, para la autenticación de dominio con <code>--username</code> y una opción de contraseña.</td></tr><tr><td><code>--timeout &#x3C;seconds></code></td><td><code>15</code></td><td>Devolutions Cloud y Devolutions Server: tiempo límite de las solicitudes hechas durante el inicio de sesión, de 3 a 600 segundos. Cualquier otro valor se rechaza. El valor no se guarda con el contexto: se aplica solo a este inicio de sesión.</td></tr><tr><td><code>--no-set-current</code></td><td>Desactivado</td><td>Guarda el contexto sin convertirlo en el actual. Para un perfil local, el contexto nuevo pasa a ser el actual cuando todavía no hay ningún contexto actual.</td></tr><tr><td><code>--workspace &#x3C;name></code></td><td></td><td>Solo perfil local: espacio de trabajo predeterminado, guardado con el contexto como indicación para las personas y los agentes. Se rechaza con <code>--cloud</code> o <code>--server</code>.</td></tr><tr><td><code>--vault &#x3C;name></code></td><td></td><td>Solo perfil local: bóveda predeterminada, guardada con el contexto como indicación para las personas y los agentes. Se rechaza con <code>--cloud</code> o <code>--server</code>.</td></tr><tr><td><code>--description &#x3C;text></code></td><td></td><td>Solo perfil local: descripción del contexto. Se rechaza con <code>--cloud</code> o <code>--server</code>.</td></tr><tr><td><code>--replace</code></td><td>Desactivado</td><td>Solo perfil local: sustituye un contexto de perfil local existente con el mismo nombre. Sin esta opción, ese nombre se rechaza. Se rechaza con <code>--cloud</code> o <code>--server</code>.</td></tr></tbody></table>

### Métodos de inicio de sesión de un vistazo

<table><thead><tr><th width="220">ESPACIO DE TRABAJO</th><th>ELIJA EXACTAMENTE UNA DE</th></tr></thead><tbody><tr><td>Devolutions Cloud</td><td><code>--oauth</code> (opcionalmente con <code>--use-device-code</code>), o <code>--application-key</code> con <code>--application-secret-env</code> o <code>--application-secret-file</code>.</td></tr><tr><td>Devolutions Server</td><td><code>--oauth</code> (opcionalmente con <code>--use-device-code</code>), <code>--api-key-env</code> o <code>--api-key-file</code>, <code>--username</code> con <code>--password-env</code> o <code>--password-file</code> (opcionalmente con <code>--domain-id</code> o <code>--as-application</code>), o <code>--windows-auth</code>. Sin un método de inicio de sesión, o con más de uno, el comando se detiene.</td></tr><tr><td>Perfil local</td><td>Sin inicio de sesión: <code>--sqlite &#x3C;folder></code>, opcionalmente con <code>--workspace</code>, <code>--vault</code>, <code>--description</code> y <code>--replace</code>.</td></tr></tbody></table>

{% hint style="info" %}
Devolutions CLI no guarda secretos de aplicación, claves de API ni contraseñas. Guarda el nombre de la variable de entorno o la ruta del archivo, y vuelve a leer el valor cada vez que un comando lo necesita. Mantenga esa variable definida, o ese archivo en su sitio, mientras use el contexto. Un inicio de sesión en el navegador se conserva en el almacén seguro de su sistema operativo.
{% endhint %}

Antes de guardar un contexto de Devolutions Cloud o Devolutions Server, `devo login` comprueba el inicio de sesión con el espacio de trabajo. Si la comprobación falla, no se guarda nada. Los errores en las propias opciones detienen el comando con el código de salida `2`; un inicio de sesión fallido termina con `1`. Consulte [Códigos de salida y errores](/cli/es/referencia/exit-codes-and-errors.md).

## devo logout

Borra el inicio de sesión almacenado de un contexto de Devolutions Cloud o de Devolutions Server. El propio contexto se conserva: vuelva a iniciar sesión con `devo login`, o elimínelo con `devo context delete`.

**Espacio de trabajo:** Devolutions Cloud, Devolutions Server

```bash
devo logout [<name>]
```

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Contexto actual</td><td>Contexto del que cerrar sesión. Sin él, se usa el contexto actual; si no hay un contexto actual, el comando se detiene y pide un nombre. Un contexto de perfil local se rechaza, porque no tiene inicio de sesión. Para un inicio de sesión en el navegador, la sesión guardada en el almacén seguro también se elimina.</td></tr></tbody></table>

## devo status

Muestra el espacio de trabajo seleccionado: su contexto, su tipo y, para Devolutions Cloud o Devolutions Server, si ha iniciado sesión.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

```bash
devo status [<name>] [--online]
```

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Espacio de trabajo seleccionado</td><td>Contexto que mostrar. Sin él, se muestra el espacio de trabajo seleccionado por <code>--source</code>, <code>--context</code> o el contexto actual. Un nombre desconocido es un error. Para un perfil local, el estado muestra el contexto y su carpeta de perfil. Con <code>--source cloud</code> o <code>--source server</code> y sin nombre de contexto, se usa el contexto actual de ese tipo; si no hay ninguno, el estado dice que no ha iniciado sesión en lugar de fallar.</td></tr><tr><td><code>--online</code></td><td>Desactivado</td><td>Devolutions Cloud y Devolutions Server: contacta con el espacio de trabajo para comprobar que el inicio de sesión sigue funcionando. Si la comprobación falla, el comando informa del error y termina con el código <code>1</code>. Sin <code>--online</code>, el estado procede de lo guardado en su ordenador y no se contacta con nada. No tiene efecto en un perfil local.</td></tr></tbody></table>

## devo info

Muestra información sobre una instancia de Devolutions Cloud o de Devolutions Server, para un contexto guardado o para una dirección, sin iniciar sesión.

**Espacio de trabajo:** Devolutions Cloud, Devolutions Server

```bash
devo info [<name>]
devo info --cloud <url>
devo info --server <url>
devo info <name> --private
```

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Espacio de trabajo seleccionado</td><td>Contexto que consultar. Sin él y sin una dirección, se usa el espacio de trabajo seleccionado. Un perfil local se rechaza: el comando funciona solo con Devolutions Cloud y Devolutions Server. No se puede combinar con <code>--cloud</code> o <code>--server</code>. Con un contexto guardado y sin <code>--private</code>, solo se devuelve información pública y no se usa el inicio de sesión del contexto.</td></tr><tr><td><code>--cloud &#x3C;url></code></td><td></td><td>Dirección de Devolutions Cloud que consultar sin un contexto guardado. Las mismas reglas de dirección que <code>devo login</code>. No se puede combinar con <code>--server</code> ni con un nombre de contexto.</td></tr><tr><td><code>--server &#x3C;url></code></td><td></td><td>Dirección de Devolutions Server que consultar sin un contexto guardado. Solo se devuelve información pública. No se puede combinar con <code>--cloud</code> ni con un nombre de contexto.</td></tr><tr><td><code>--private</code></td><td>Desactivado</td><td>Solo Devolutions Server: añade información privada, usando el inicio de sesión de un contexto guardado. Se rechaza con <code>--server &#x3C;url></code>, y se rechaza para Devolutions Cloud.</td></tr></tbody></table>

## devo context list

Enumera sus contextos de cada tipo de espacio de trabajo, ordenados por nombre, y muestra cuál es el actual. Alias: `devo context ls`.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

```bash
devo context list
```

Este comando no tiene argumentos ni opciones propios.

## devo context use

Convierte un contexto en el actual. Cada comando posterior lo usa, hasta que usted elija otro o lo sustituya para un comando con la opción global `--context <name>`.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

```bash
devo context use <name>
```

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Contexto que convertir en actual. Obligatorio. Si el mismo nombre existe para más de un tipo de contexto, el comando se detiene y le dice que elimine uno de ellos con <code>devo context delete &#x3C;name> --kind &#x3C;kind></code>.</td></tr></tbody></table>

## devo context inspect

Muestra los detalles de un contexto: su tipo, su dirección o su carpeta de perfil y, para un perfil local, su espacio de trabajo predeterminado, su bóveda predeterminada y su descripción.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

```bash
devo context inspect [<name>]
```

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td>Contexto actual</td><td>Contexto que mostrar. Sin él, se muestra el contexto actual; si ningún contexto es el actual, el comando se detiene y pide un nombre.</td></tr></tbody></table>

## devo context delete

Quita un contexto. Alias: `devo context rm`. Si era el contexto actual, después ningún contexto es el actual.

**Espacio de trabajo:** Todos los tipos de espacio de trabajo

```bash
devo context delete <name> [--kind <kind>] [--yes]
```

<table><thead><tr><th width="300">OPCIÓN</th><th width="130">PREDETERMINADO</th><th>QUÉ HACE</th></tr></thead><tbody><tr><td><code>&#x3C;name></code></td><td></td><td>Contexto que eliminar. Obligatorio. Eliminar un contexto de perfil local quita solo el contexto: la carpeta de perfil no se toca.</td></tr><tr><td><code>--kind &#x3C;kind></code></td><td></td><td>Tipo de contexto que eliminar, cuando el mismo nombre existe para más de un tipo: <code>sqlite</code> (perfil local), <code>cloud</code> o <code>server</code>. Cualquier otro valor se rechaza.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Desactivado</td><td>Confirma la eliminación de un contexto de Devolutions Cloud o de Devolutions Server, lo que también descarta su inicio de sesión almacenado. Sin ella, ese contexto no se elimina. No hace falta para un contexto de perfil local.</td></tr></tbody></table>

## Siguiente

* [Secret commands](/cli/es/referencia/commands/secrets.md)
* [MCP, background process, and configuration commands](/cli/es/referencia/commands/mcp-daemon-config.md)
* [Global options](/cli/es/referencia/global-options.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/cli/es/referencia/commands/sign-in-and-contexts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.