> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Variáveis de ambiente do Narya

> As variáveis de ambiente que o host do Narya e o comando narya leem, com cada padrão e o que ela muda.

O Narya lê estas variáveis do ambiente do processo que o roda: o host, ou o comando `narya` que você digita. Todas as variáveis são opcionais.

## Pasta Narya

| Variável | Padrão | O que faz |
| :- | :- | :- |
| `NARYA_HOME` | `$XDG_CONFIG_HOME/narya`, senão `~/.config/narya` | A pasta Narya: o armazenamento, o socket, o `config.toml`, as suas regras de permissão e o diretório de credenciais. Um caminho relativo resolve contra o diretório de trabalho. |
| `XDG_CONFIG_HOME` | — | Quando `NARYA_HOME` não está definida, a pasta Narya é `$XDG_CONFIG_HOME/narya`. |

## Modelos

| Variável | Padrão | O que faz |
| :- | :- | :- |
| `<PROVIDER>_API_KEY` | — | A chave desta máquina para um provedor, como `ANTHROPIC_API_KEY`, `OPENAI_API_KEY` ou `OPENROUTER_API_KEY`. Ela vence o keychain e o arquivo de credenciais em cada leitura. Veja [Modelos e credenciais](https://docs.lerian.studio/pt/platform/narya/models-and-credentials.md#where-your-key-comes-from). |
| `NARYA_MODELS_URL` | `https://models.dev/api.json` | O catálogo de modelos que o host lê a cada 12 horas. `off` para essa leitura e a listagem de modelos de cada provedor. |

## Ambientes

| Variável | Padrão | O que faz |
| :- | :- | :- |
| `NARYA_SANDBOX_IMAGE` | — | A imagem de contêiner dos ambientes. Sem ela, o host não provisiona nenhum ambiente. A imagem já deve estar no daemon do Docker. |
| `DOCKER_HOST` | `unix:///var/run/docker.sock` | O daemon do Docker que roda os ambientes. O Narya lê apenas um endereço `unix://` e usa o padrão para qualquer outro valor. |

## Telemetria e logs

Estas variáveis vencem as tabelas `[telemetry]` e `[logging]` do `config.toml`.

| Variável | Padrão | O que faz |
| :- | :- | :- |
| `OTEL_EXPORTER_OTLP_ENDPOINT` | — | O coletor OpenTelemetry, como `host:port`, com um `http://` ou `https://` opcional. Defini-la liga a telemetria. O Narya envia a um endpoint `http://` sem TLS e a um endpoint `https://` com TLS. |
| `OTEL_EXPORTER_OTLP_INSECURE` | `false` | Com `true`, o Narya envia sem TLS a um endpoint `host:port` sem `http://` ou `https://`. Com `true` e um endpoint `https://`, o Narya não inicia. |
| `OTEL_TRACES_SAMPLER_ARG` | `1` | A fração de traces que o Narya envia, acima de `0` e no máximo `1`. |
| `OTEL_SERVICE_NAME` | Definido pelo Narya | O nome do processo no coletor. |
| `OTEL_SDK_DISABLED` | — | Com `true`, a telemetria fica desligada, seja o que for que os outros ajustes digam. |
| `LOG_LEVEL` | `info` | `debug`, `info`, `warn` ou `error`. |
| `LOG_ENCODING` | `json` | `json` ou `console`. |

## Cliente de terminal

| Variável | Padrão | O que faz |
| :- | :- | :- |
| `VISUAL`, `EDITOR` | — | O editor que o cliente interativo abre para um rascunho. O Narya lê `VISUAL` primeiro. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.