omm

omm setting

텔레메트리, 이 머신에서 나갈 수 있는 익명 데이터, 메모리 보호, 업데이트 채널, 색상 테마, 보정값, 서명된 카탈로그 신뢰까지 — 대화형으로, 또는 하위 명령 하나씩.

01 / 06

개요

명령 하나가 아니라 omm이 전반적으로 어떻게 동작하는지 보거나 바꾸고 싶을 때 쓰는 명령입니다. 그냥 omm setting은 아래 하위 명령과 같은 범위를 다루는 대화형 메뉴를 엽니다. 각 하위 명령도 직접 쓸 수 있고, 어느 쪽이든 현재 값을 작은 표로 보여주며, 여기서 뭘 바꾸든 로컬에만 남습니다 — 설정을 바꿨다고 뭔가 업로드되지는 않습니다. omm이 보낼 수 있는 데이터는 이제 omm setting upload 하나 아래로 모였고, 채널별로 정책이 따로입니다: 벤치마크 결과, 익명 사용 통계, 크래시 리포트. 사용 통계와 크래시 리포트는 직접 켜기 전까지 꺼져 있습니다.

02 / 06

옵션

이 명령이 받는 모든 옵션과, 생략했을 때의 기본값입니다.

  • setting telemetry --endpoint URL—기본값: not configured

    벤치마크 텔레메트리를 어디로 보낼지 설정하거나, --endpoint none으로 지웁니다.

  • setting upload—기본값: show all three policies

    외부 전송 정책 세 가지(benchmark·usage·crash)를 한 표로 보여줍니다.

  • setting upload benchmark --enable|--disable|--ask—기본값: ask

    벤치마크 결과를 묻지 않고 보낼지, 절대 안 보낼지, 매번 물을지 설정합니다.

  • setting upload usage --enable|--disable|--reset-id—기본값: off

    익명 일일 사용 통계: omm 버전, 설치 방식, OS, CPU/GPU 종류, RAM·VRAM 용량 구간, 실행한 명령. 모델 이름·검색어·파일 경로·IP·호스트명은 절대 보내지 않습니다. 플래그 없이 실행하면 다음에 보낼 페이로드를 그대로 출력하고, --reset-id는 새 무작위 설치 id를 만듭니다.

  • setting upload crash --enable|--disable|--ask—기본값: off

    긁어낸 정보만 담는, 별도의 옵트인 크래시 리포트 정책을 설정합니다 — 전용 쓰기 전용 채널로 나갑니다.

  • setting memory-guard --policy ask|block|observe --poll-seconds N --low-memory-seconds N—기본값: show current values

    Memory Guard 정책, 확인 간격(0.1~60초), 저메모리가 취소 전까지 지속돼야 하는 시간(0~300초)을 설정합니다.

  • setting version --stable|--beta—기본값: stable

    omm update가 어느 브랜치에서 가져올지 보거나 바꿉니다.

  • setting theme --set NAME—기본값: dark

    omm 출력 색상 테마를 보거나 바꿉니다.

  • setting calibrate [name]—기본값: smallest Ollama model

    실제 Ollama 연결 모델로 이 머신의 로컬 속도 예측을 보정합니다 — 절대 업로드되지 않습니다.

  • setting catalog-trust --manifest-url URL --public-key KEY—기본값: unset

    앞으로의 추천 다운로드가 Ed25519 서명 검증을 통과하도록 요구합니다.

  • setting catalog-status—기본값: —

    현재 서명된 카탈로그 신뢰·롤백 상태를 보여줍니다.

  • setting catalog-rollback—기본값: —

    가장 최근의 다른 추천 스냅샷으로 복원합니다.

03 / 06

예제

기본 검색부터 스크립트에 넣을 만한 형태까지.

아래 모든 설정을 다루는 대화형 메뉴를 엽니다.

$ omm setting

현재 색상 테마를 보여줍니다.

$ omm setting theme

외부 전송 정책 세 가지를 한 번에 보여줍니다.

$ omm setting upload

익명 사용 통계를 끄고, 이미 쌓인 대기 행도 버립니다.

$ omm setting upload usage --disable

서명된 카탈로그 신뢰·롤백 상태를 보여줍니다.

$ omm setting catalog-status

04 / 06

실제 실행 예시

2026-09-01, 임시 OMM_HOME 기준으로 실제로 실행한 omm setting upload(플래그 없음)입니다 — 한 번도 묻지 않은 머신의 실제 기본 정책 세 가지를, 표 아래 안내 줄까지 그대로 실었습니다. 표 테두리는 이 페이지 세트 전체 규칙대로 웹에서 뺐습니다.

06 / 06

문제가 생겼다면

아래 메시지는 모두 이 명령이 실제로 출력하는 것들입니다. 해당하는 메시지를 찾아 원인을 읽고, 마지막 줄대로 하면 됩니다.

  1. Choose only one of --enable, --disable, or --ask.
    원인
    omm setting upload benchmark와 omm setting upload crash는 각각 정책 플래그를 정확히 하나만 받는데, 이번 실행에서는 두 개 이상을 줬습니다.
    대처
    --enable, --disable, --ask 중 하나만 주세요.
    출처
    src/omm/cli.py:6454, :6489
  2. Set an endpoint with `omm setting telemetry --endpoint` before enabling uploads.
    원인
    텔레메트리 엔드포인트가 없으면 벤치마크 업로드는 보낼 곳 자체가 없습니다. 그래서 --enable은 절대 보낼 수 없는 정책을 조용히 켜는 대신 거부합니다.
    대처
    omm setting telemetry --endpoint URL을 먼저 실행한 다음 --enable을 다시 주세요.
    출처
    src/omm/cli.py:6459-6460
  3. The signed catalog manifest must use HTTPS.
    원인
    서명된 카탈로그 검증은 전송 중 조작될 수 없는 연결 위에서 이뤄져야 합니다 — HTTP 매니페스트 URL은 서명을 요구하는 의미 자체를 무너뜨립니다.
    대처
    HTTPS 매니페스트 URL을 쓰세요.
    출처
    src/omm/cli.py:6828
  4. --policy must be ask, block, or observe.
    원인
    Memory Guard 정책은 실제 값이 세 개뿐인데, 이번 실행에서는 다른 값을 줬습니다.
    대처
    ask, block, observe 중 하나를 쓰세요.
    출처
    src/omm/cli.py:6602

그래도 해결되지 않는다면, 화면에 뜬 메시지 그대로를 첨부해 이슈를 등록하세요.

전체 명령어