환경 변수

OpenChamber는 시작할 때 이 변수들을 읽습니다. 시작 서비스는 openchamber startup enable 실행 시 기본적으로 현재 환경의 snapshot을 저장하므로, 서비스에 적용할 변수를 바꾼 뒤에는 다시 실행하세요.

OpenChamber 서버

`OPENCHAMBER_HOST`

OpenChamber 웹 서버가 바인딩할 주소입니다. 다른 컴퓨터에서 접속해야 하면 0.0.0.0을 사용하세요.

`OPENCHAMBER_UI_PASSWORD`

브라우저 UI 비밀번호입니다. localhost 밖으로 바인딩하거나 터널, 리버스 프록시를 사용할 때 설정하세요.

`OPENCHAMBER_DATA_DIR`

OpenChamber 데이터 디렉터리를 바꿉니다. 기본값은 ~/.config/openchamber입니다.

`OPENCHAMBER_COMPRESS_API`

API 응답 압축을 제어합니다. true 또는 1은 켜고, false 또는 0은 끕니다.

`OPENCHAMBER_SKIP_API_COMPRESSION`

true 또는 1이면 API 응답 압축을 끕니다. OPENCHAMBER_COMPRESS_API보다 우선합니다.

`OPENCHAMBER_VERBOSE_REQUEST_LOGS`

true 또는 1이면 자세한 HTTP request logs를 켭니다.

`OPENCHAMBER_UPDATE_API_URL`

업데이트 확인 API endpoint를 바꿉니다. 대부분의 사용자는 설정하지 않아도 됩니다.

`OPENCHAMBER_PACKAGE_MANAGER`

자동 감지가 틀렸을 때 업데이트에 사용할 package manager를 강제로 지정합니다.

OpenCode 서버

`OPENCODE_HOST`

OpenChamber를 이미 실행 중인 OpenCode server에 연결합니다. 값은 명시적 포트가 있고 path, query, hash가 없는 http 또는 https origin이어야 합니다. OPENCODE_HOST는 OPENCODE_PORT보다 우선합니다.

`OPENCODE_PORT`

OpenCode server 포트를 설정합니다. managed OpenCode에서는 이 포트를 요청하고, OPENCODE_SKIP_START=true와 함께 쓰면 해당 포트의 외부 서버에 연결합니다.

`OPENCODE_SKIP_START`

true이면 OpenChamber가 자체 OpenCode server를 시작하지 않습니다.

`OPENCHAMBER_OPENCODE_HOSTNAME`

OpenChamber가 관리하는 OpenCode server의 bind hostname입니다. 기본값은 127.0.0.1입니다.

`OPENCODE_BINARY`

OpenChamber가 실행할 opencode executable 경로입니다.

`OPENCODE_CONFIG`

특정 OpenCode config 파일 경로입니다.

`OPENCODE_CONFIG_DIR`

agents, skills, snippets, config discovery에 사용할 OpenCode config 디렉터리입니다.

`OPENCODE_DATA_DIR`

managed OpenCode server의 사용자 지정 데이터 디렉터리입니다.

`OPENCODE_WSL_DISTRO`

Windows에서 OpenCode 연동에 사용할 WSL distro를 선택합니다.

`OPENCHAMBER_OPENCODE_WSL_DISTRO`

WSL distro를 선택하는 OpenChamber 전용 alias입니다. 둘 다 설정하면 OPENCODE_WSL_DISTRO가 우선합니다.

`OPENCODE_JWT_SECRET`

UI auth tokens 서명에 사용하는 secret입니다. 지속 실행 서비스에서는 긴 무작위 값을 사용하세요.

Terminal 및 Git

`OPENCHAMBER_TERMINAL_SHELL`

OpenChamber terminal sessions에서 사용할 shell executable입니다.

`OPENCHAMBER_GIT_BINARY`

OpenChamber Git 기능에서 사용할 Git executable입니다.

`GIT_BINARY`

Git executable의 대체 override입니다. OpenChamber 전용 설정에는 OPENCHAMBER_GIT_BINARY를 권장합니다.

`OPENCHAMBER_GIT_READ_CACHE_TTL_MS`

Git-backed file reads cache의 TTL이며 단위는 밀리초입니다. 디버깅 중 cache를 끄려면 0으로 설정하세요.

음성 및 터널

`OPENAI_API_KEY`

OpenAI-compatible services를 호출하는 OpenChamber 음성 기능에 사용하는 API key입니다.

`OPENCHAMBER_ALLOW_REMOTE_OPENAI_COMPAT_URLS`

true 또는 1이면 음성 기능에서 원격 OpenAI-compatible base URLs를 허용합니다.

`NGROK_AUTHTOKEN`

OpenChamber tunnel commands에서 사용하는 ngrok auth token입니다. ngrok config add-authtoken <token>으로도 설정할 수 있습니다.

Runtime helpers

`BUN_BINARY`

OpenChamber가 daemon processes를 시작할 때 사용할 Bun executable입니다.

`BUN_INSTALL`

Bun 설치 루트입니다. OpenChamber는 daemon 시작과 업데이트를 위해 여기서 bin/bun을 찾습니다.

`VITE_OPENCODE_URL`

Vite-built web app의 build-time API base URL입니다. 일반 CLI 또는 desktop 사용에서는 대부분 설정할 필요가 없습니다.