---
title: "Configuration and data · Alran Code Docs"
url: https://alran.dev/en/docs/config
locale: en
updated: 2026-11-16
---

[Docs](https://alran.dev/en/docs)Reference

# Configuration and data

Where Alran Code keeps its data, and the variables that change it.

On this page

[Where does Alran Code keep my data?](#data) [In your project](#project) [Environment variables](#env) [Telemetry](#telemetry) [Common questions](#faq)

## Where does Alran Code keep my data? {#data}

Sign-in, settings, provider configuration (`config.yaml`), sessions, plugins, caches and logs live in `~/.alran`. A profile uses `~/.alran-<profile>`. Keep these folders private and out of Git: `config.yaml` can hold API keys.

## In your project {#project}

| File | What it does |
| `AGENTS.md` | Project guidance every session reads first (`alran init .` writes it) |
| `.mcp.json` | MCP servers for this project ([MCP](https://alran.dev/en/docs/mcp)) |

## Environment variables {#env}

| Variable | What it does | Default |
| `ALRAN_API_KEY` | An Ottili API key for this run; overrides the stored sign-in | not set |
| `ALRAN_DATA_DIR` | Where data lives | `~/.alran` |
| `ALRAN_LOGIN_FLOW` | `device` or `browser` for `alran auth login` | decided by the terminal |
| `ALRAN_NO_UPDATE_CHECK` | `1` turns off the weekly update hint | not set |
| `ALRAN_API_BASE` | Another Ottili AI Gateway | `https://ai.ottili.one/v1` |
| `OTTILI_PLATFORM_URL` | Another Ottili Platform for sign-in | `https://platform.ottili.one` |
| `ALRAN_STORE_URL` | Address of the default store; `off` switches it off | Ottili's store |
| `ALRAN_PLUGIN_REGISTRY_URL` | A plugin registry you run | not set |
| `ALRAN_UPDATE_SOURCE` | A mirror for `alran update` | npm |

## Telemetry {#telemetry}

Alran Code reports no usage to any host unless `ALRAN_TELEMETRY_ENDPOINT` is set. `alran telemetry` shows what would be sent.

## Common questions {#faq}

Where does Alran Code keep my data?

Sign-in, settings, the provider configuration in config.yaml, sessions, plugins, caches and logs live in the folder ~/.alran. Keep this folder private and out of Git, because config.yaml can hold API keys, and a profile keeps its data in a folder of its own.

Which files belong in my project folder?

AGENTS.md holds the project guidance that every session reads first, and the command alran init . writes it. .mcp.json holds the MCP servers for this project.

Which environment variables can I set?

ALRAN_API_KEY overrides the stored sign-in for this run, ALRAN_DATA_DIR sets where the data lives, and ALRAN_LOGIN_FLOW chooses device or browser for alran auth login. ALRAN_NO_UPDATE_CHECK turns off the weekly update hint, ALRAN_API_BASE and OTTILI_PLATFORM_URL point to another gateway or platform, ALRAN_STORE_URL sets the address of the default store, ALRAN_PLUGIN_REGISTRY_URL names a registry you run, and ALRAN_UPDATE_SOURCE names a mirror for alran update. Alran Code reports no usage to any host unless you set ALRAN_TELEMETRY_ENDPOINT.

[PreviousSlash commands](https://alran.dev/en/docs/commands) [NextError codes](https://alran.dev/en/docs/errors)
