구성

이 페이지는 셀프 호스팅 Nodaro의 구성 레퍼런스입니다. 운영자가 설정하는 모든 환경 변수를 용도별로 묶어 기본값과 함께 정리했습니다. 번들된 Compose 스택에서는 모든 변수에 작동하는 기본값이 있으므로, 바꾸고 싶은 것만 설정하면 됩니다. Nodaro Cloud에만 적용되는 변수는 싣지 않았습니다.

변수 설정 방법

Compose 스택에서는 두 곳 중 한 곳에서 변수를 설정합니다.

• .env에서. docker-compose.community.yml 옆에 있는 파일입니다. Compose 파일이 앱에 전달하는 변수에만 적용됩니다. 아래 표의 .env 열에 예로 표시된 변수입니다.
• Compose 파일에서. 그 밖의 모든 변수가 해당합니다. nodaro 서비스의 environment: 아래에 추가하세요.

  nodaro:
    environment:
      # ...the variables already listed...
      MCP_ENABLED: "true"
      MCP_PUBLIC_URL: https://mcp.nodaro.example.com

그다음 변경 사항을 적용하세요.

docker compose -f docker-compose.community.yml up -d

Nodaro는 부팅할 때 환경을 읽습니다. 유일한 예외는 /setup에 붙여 넣은 공급자 키로, 즉시 적용됩니다. Compose 스택 밖에서는 플랫폼의 환경 설정에서 변수를 설정하세요.

Compose 스택 밖에서 필수: SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, INTERNAL_ORCHESTRATOR_SECRET. 이 변수가 없으면 API가 시작을 거부하고, 없거나 잘못된 변수를 나열합니다.

인스턴스

시크릿

시크릿은 openssl rand -hex 32로 생성하세요. 암호화 키는 데이터베이스와 함께 백업하세요. 백업과 복원을 참고하세요.

데이터베이스와 로그인

큐

스토리지

모델 공급자

이 키는 모두 /setup에 붙여 넣을 수도 있습니다. 환경에 설정한 키가 우선합니다. 공급자 키를 참고하세요.

Nodaro Cloud 연결

NODARO_API_KEY와 R2_SHARED_WITH_RELAY_TARGET도 연결에 속합니다. Nodaro Cloud에 연결을 참고하세요.

워커와 성능

이 값을 올리기 전에 확장을 읽어 보세요.

편집기

동영상 및 오디오 편집기를 참고하세요.

업데이트

업데이트를 참고하세요.

MCP

MCP를 참고하세요.

로그인과 역할

싱글 사인온과 첫 사용자와 관리자를 참고하세요.

연동

Figma 플러그인을 쓰려면 내 설치에 개발자 앱을 등록하세요. 리디렉션 URI는 <PUBLIC_URL>/v1/oauth/plugin/callback, 범위는 jobs:read, assets:read, assets:write, credits:read입니다. 그다음 그 앱의 클라이언트 ID를 여기에 설정하세요. 변수가 비어 있으면 플러그인 연결 경로가 503으로 응답하고, 다른 것은 바뀌지 않습니다. OAuth 앱을 참고하세요.

빌드 시점 설정

이 값은 이미지를 빌드할 때 고정됩니다. Compose 파일의 build: args:에서 바꾼 뒤 다시 빌드하세요.

동영상 및 오디오 편집기

캔버스의 동영상 결과에 있는 NodarCut에서 편집과 앱의 동영상 결과에 있는 편집은 NodarCut 동영상 편집기를 엽니다. 앱의 오디오 결과에 있는 편집은 AudioMass 편집기를 엽니다. 내 미디어는 편집기의 서버로 가지 않습니다. 앱이 내 스토리지에서 파일을 읽어 브라우저 안에서 편집기에 넘깁니다. 편집과 내보내기도 브라우저에서 이루어집니다.

• 동영상. FREECUT_URL이 비어 있으면 편집기를 freecut.nodaro.ai에서 불러오는데, 이 주소는 http://localhost:3000에서만 임베드를 허용합니다. LAN 주소나 도메인 같은 다른 오리진에서는 브라우저가 이를 거부하고, 패널에 그 이유가 표시됩니다. 내가 제공하는 URL을 허용받으려면 GitHub에 그 URL로 이슈를 열거나, 직접 FreeCut을 실행하세요. FreeCut은 MIT 라이선스로 공개되어 있으며 Dockerfile을 함께 제공합니다. 그다음 FREECUT_URL=https://freecut.example.internal로 설정하세요.
• 오디오. 공개적으로 호스팅되는 AudioMass가 없으므로, 구성하기 전까지는 오디오 결과의 편집이 편집기를 열지 않습니다. 프레젠테이션 탭에서는 아무 동작도 하지 않고, 편집기 밖에서는 무엇을 설정해야 하는지 설명하는 패널을 보여 줍니다. 원래 AudioMass에 없는 브라우저 내 전달을 지원하는 Nodaro의 분기본 AudioMass를 실행하세요. 그다음 AUDIOMASS_URL=https://audiomass.example.internal로 설정하세요.

변경한 뒤에는 스택을 재시작하세요. 다시 빌드할 필요는 없습니다.

모델 제작사 로고

GET /v1/models는 각 모델의 제작사를 알려 주며, 모델 선택기를 그리는 앱을 위해 제작사 로고를 logoUrl로 함께 보낼 수 있습니다. 회사의 로고는 그 회사의 상표이므로, Nodaro에는 로고가 하나도 포함되어 있지 않습니다. 설치는 표시할 권리가 있는 로고만 게시합니다. 나머지 제작사의 logoUrl은 null이며, 그러면 앱은 제작사 이름을 표시합니다. 로고를 게시하지 않는 설치는 설정할 것이 없습니다.

제작사 로고를 게시하려면:

1. 파일을 업로드하세요. R2_PUBLIC_URL 뒤의 버킷에 brand/makers/<maker id>.svg 경로로, 콘텐츠 타입 image/svg+xml로 올립니다. 스크립트가 없는 SVG로 된 회사의 공식 로고를 쓰세요. 제작사 ID는 GET /v1/models가 반환하는 maker.id 값입니다.
2. 제작사 ID를 선언하세요. 인스턴스 설정 model_maker_logos에 ["google", "openai"] 같은 목록으로 적습니다. Business 설치에서는 플랫폼 운영자가 PUT /v1/admin/settings/model_maker_logos와 본문 {"value": ["google", "openai"]}로 설정합니다. 관리자 패널이 없는 Community Edition에서는 같은 인스턴스 설정을 데이터베이스에 직접 씁니다.

• 서버가 먼저 파일을 확인합니다. 선언된 제작사는 파일이 SVG로 버킷에 있을 때만 logoUrl을 받으므로, 두 단계는 어느 순서로 해도 됩니다. 파일이 없거나 타입이 잘못되면 깨진 주소가 아니라 null이 됩니다.
• 업로드를 확인하려고 브라우저에서 주소를 열지 마세요. CDN과, 번들 스택의 Caddy는 “찾을 수 없음” 응답을 1년 동안 보관합니다. 스토리지 콘솔이나 curl -I 같은 HEAD 요청으로 파일을 확인하세요.
• 반영 시간. 새 로고는 약 10분 안에 나타납니다. 로고를 바꾸려면 새 파일을 이전 파일 위에 업로드하세요. 주소는 파일에 따라 바뀝니다. 로고를 내리려면 설정에서 ID를 빼거나 파일을 삭제하세요.
• Nodaro는 이 파일을 절대 삭제하지 않습니다. 로고를 지우려면 스토리지 콘솔에서 직접 삭제하세요.

기본 언어

DEFAULT_LOCALE은 새 방문자가 시작하는 언어를 정합니다. 값은 he, ar, de, fr, es, hi, ja, ko, pt-BR, ru, zh-CN, en입니다. 사용자가 직접 저장한 선택이 항상 우선합니다. 비어 있거나 공백이거나 알 수 없는 값이면 방문자의 브라우저 언어로 대체됩니다. 적용하려면 재시작하세요. 언어를 참고하세요.

튜토리얼 팩

셀프 호스팅 설치는 다시 빌드하지 않고도 기본 제공 튜토리얼에 내 튜토리얼을 추가할 수 있습니다. 팩마다 디렉터리 하나로 구성됩니다.

• manifest.json: 팩의 name과 팩의 튜토리얼이 쓰는 categories입니다. 카테고리마다 slug, name이 있고, 선택적으로 sortOrder와 description이 있습니다. 선택 키는 locale, version, forbiddenPromptTerms, 그리고 팩의 모든 카드에 표시되는 작성자 이름인 creatorDisplayName입니다.
• 튜토리얼마다 *.json 파일 하나: 노드, 연결, 이미 만들어진 결과가 담긴 워크플로 스냅숏이므로, 복제하면 완료된 실행이 표시된 상태로 열립니다. 선택적 카드 데이터로 실행 한 번의 크레딧인 estimatedCredits를 넣을 수 있습니다. 가격이 주어진 녹음의 길이에 따라 정해지는 튜토리얼은 estimatedPerMinuteCredits도 넣습니다. 이때 estimatedCredits는 고정 부분이고, estimatedPerMinuteCredits는 녹음 1분당 크레딧입니다. 그 밖의 선택적 데이터는 카드의 칩에 쓰는 nodeTypesUsed, providersUsed, 튜토리얼별 creatorDisplayName, 그리고 listedIn입니다. listedIn은 기본값인 튜토리얼 탭용 ["tutorial"]이거나 템플릿 마켓플레이스용 ["marketplace"]입니다. 이 값은 첫 시드 때만 적용됩니다.

튜토리얼이 쓰는 모든 미디어 파일은 공개 https:// URL이어야 합니다. 각 튜토리얼의 카테고리는 매니페스트에 선언되어 있어야 하며, 첫 부팅 때 만들어집니다.

팩 디렉터리를 컨테이너에 읽기 전용으로 마운트하고, 컨테이너 안의 경로를 나열하세요.

  nodaro:
    volumes:
      - ./tutorials/acme:/data/tutorials/acme:ro

NODARO_TUTORIAL_PACKS=/data/tutorials/acme

팩은 튜토리얼을 추가하기만 하며, 기본 제공 튜토리얼을 바꾸지는 않습니다. 검증에 실패한 팩은 통째로 건너뛰고 로그에 기록합니다. 잘못된 JSON, 선언되지 않은 카테고리, 공개되지 않은 미디어 URL, 기존 튜토리얼과 겹치는 slug가 있으면 검증에 실패합니다. 바뀐 팩을 불러오려면 컨테이너를 재시작하세요.

소셜 네트워크 앱

소셜 네트워크 게시는 네트워크별로 작동합니다. 네트워크는 OAuth 앱 자격 증명을 설정하면 사용할 수 있게 됩니다. 자격 증명이 없어도 네트워크는 설정 › 연동에 사용할 수 없음으로 표시되며, 없는 변수의 이름이 함께 나옵니다.

모든 OAuth 앱은 리디렉션 URI https://<your-domain>/v1/social/callback/<network>를 허용해야 합니다. Facebook이나 Instagram 로그인 하나가 페이지나 계정을 두 개 이상 관리하면, 연결 창에서 사용자에게 어느 것을 연결할지 묻습니다. 소셜 네트워크에 게시하기를 참고하세요.